Jump to

• Request
• Response

Get the Default LDAP Configuration

get

/api/v1/configuration/ldapConfig

Returns the only supported LDAP configuration: `DEFAULT-LDAP-ID-001`. Password values are masked. Returns 404 when the default configuration is absent.

Request

Header Parameters

• Authorization(required): string
  Bearer access token. Supply as: Bearer .

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object LdapConfigDetail
  LDAP Configuration details

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LdapConfigDetail"
    }
}

Nested Schema : LdapConfigDetail

Type: object

LDAP Configuration details

Show Source

• backupHosts: array backupHosts
  Maximum Number of Items: 2

  List of backup domain controllers for AD
• bpmUserGroup: string
  Users with membership to this group can login and have full access Blockchain Platform Manager (this console) and perform life cycle operations on the Blockchain instances. Required only for AD
• caAdminGroup: string
  Users part of this group will have the authority to register other users. CA Administrator privilege is also needed to create a new Blockchain instance. Required only for AD
• connectTimeout: integer
• groupClassName: string
• groupMembershipAttribute: string
• groupNameAttribute: string
• idbClientId: string
  IDB client id. Populated only for the default LDAP configuration.
• idbClientSecret: string
  IDB client secret. Populated only for the default LDAP configuration.
• instanceAdminGroup: string
  Users with membership to this group can have full access to an instance console and perform all the operations on it via UI or REST APIs. Required only for AD
• instanceUserGroup: string
  Users with membership to this group can view an instances console via UI or REST. They will not be able to perform any other operations. Required only for AD
• ldapBaseDN: string
• ldapBindDN: string
• ldapBindPassword: string(password)
  Returned masked.
• ldapHost: string
• ldapId: string
• ldapName: string
• ldapPort: integer
• ldapTLSCACert: string
• ldapTLSEnabled: boolean
• ldapType: string
• restProxyGroup: string
  Users with membership to this group can interact with the instance using Rest Proxy APIs. Required only for AD
• tlsRootCACertFileName: string
  Existing LDAP TLS root CA certificate filename, when present.
• userClassName: string
• userNameAttribute: string

{
    "description":"LDAP Configuration details",
    "type":"object",
    "properties":{
        "ldapId":{
            "type":"string"
        },
        "ldapName":{
            "type":"string"
        },
        "ldapType":{
            "type":"string"
        },
        "ldapHost":{
            "type":"string"
        },
        "ldapPort":{
            "type":"integer"
        },
        "ldapTLSEnabled":{
            "type":"boolean"
        },
        "ldapTLSCACert":{
            "type":"string"
        },
        "ldapBaseDN":{
            "type":"string"
        },
        "ldapBindDN":{
            "type":"string"
        },
        "ldapBindPassword":{
            "type":"string",
            "format":"password",
            "description":"Returned masked."
        },
        "userNameAttribute":{
            "type":"string"
        },
        "userClassName":{
            "type":"string"
        },
        "groupNameAttribute":{
            "type":"string"
        },
        "groupMembershipAttribute":{
            "type":"string"
        },
        "groupClassName":{
            "type":"string"
        },
        "connectTimeout":{
            "type":"integer"
        },
        "bpmUserGroup":{
            "type":"string",
            "description":"Users with membership to this group can login and have full access Blockchain Platform Manager (this console) and perform life cycle operations on the Blockchain instances. Required only for AD"
        },
        "caAdminGroup":{
            "type":"string",
            "description":"Users part of this group will have the authority to register other users. CA Administrator privilege is also needed to create a new Blockchain instance. Required only for AD"
        },
        "instanceUserGroup":{
            "type":"string",
            "description":"Users with membership to this group can view an instances console via UI or REST. They will not be able to perform any other operations. Required only for AD"
        },
        "instanceAdminGroup":{
            "type":"string",
            "description":"Users with membership to this group can have full access to an instance console and perform all the operations on it via UI or REST APIs. Required only for AD"
        },
        "restProxyGroup":{
            "type":"string",
            "description":"Users with membership to this group can interact with the instance using Rest Proxy APIs. Required only for AD"
        },
        "backupHosts":{
            "type":"array",
            "description":"List of backup domain controllers for AD",
            "maxItems":2,
            "items":{
                "type":"string"
            }
        },
        "tlsRootCACertFileName":{
            "type":"string",
            "description":"Existing LDAP TLS root CA certificate filename, when present."
        },
        "idbClientId":{
            "type":"string",
            "description":"IDB client id. Populated only for the default LDAP configuration."
        },
        "idbClientSecret":{
            "type":"string",
            "description":"IDB client secret. Populated only for the default LDAP configuration."
        }
    }
}

Nested Schema : backupHosts

Type: array

Maximum Number of Items: 2

List of backup domain controllers for AD

Show Source

• Array of: string

{
    "type":"array",
    "description":"List of backup domain controllers for AD",
    "maxItems":2,
    "items":{
        "type":"string"
    }
}

401 Response

Unauthorized

Body ()

Root Schema : AuthError

Type: object

Authentication or authorization error returned by request filters.

Show Source

• code(required): string
  Allowed Values: [ "UNAUTHENTICATED", "FORBIDDEN", "NOT_FOUND" ]
• message(required): string

{
    "description":"Authentication or authorization error returned by request filters.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "enum":[
                "UNAUTHENTICATED",
                "FORBIDDEN",
                "NOT_FOUND"
            ]
        },
        "message":{
            "type":"string"
        }
    }
}

403 Response

Forbidden. The authenticated caller lacks a required global role, instance-access-group membership, or a valid CSRF token.

Body ()

Root Schema : AuthError

Type: object

Authentication or authorization error returned by request filters.

Show Source

• code(required): string
  Allowed Values: [ "UNAUTHENTICATED", "FORBIDDEN", "NOT_FOUND" ]
• message(required): string

{
    "description":"Authentication or authorization error returned by request filters.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "enum":[
                "UNAUTHENTICATED",
                "FORBIDDEN",
                "NOT_FOUND"
            ]
        },
        "message":{
            "type":"string"
        }
    }
}

404 Response

Not Found

Body ()

Root Schema : Error

Type: object

Error Information.

Show Source

• errors: array errors
  list of errors
• message(required): string
  A human-readable error string.
• status(required): string
  A short error status that defines the error, meant for programmatic parsing.
• warnings: array warnings
  list of warnings

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : errors

Type: array

list of errors

Show Source

• Array of: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

Nested Schema : warnings

Type: array

list of warnings

Show Source

• Array of: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

500 Response

Internal Server Error

Body ()

Root Schema : Error

Type: object

Error Information.

Show Source

• errors: array errors
  list of errors
• message(required): string
  A human-readable error string.
• status(required): string
  A short error status that defines the error, meant for programmatic parsing.
• warnings: array warnings
  list of warnings

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : errors

Type: array

list of errors

Show Source

• Array of: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

Nested Schema : warnings

Type: array

list of warnings

Show Source

• Array of: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

Back to Top