Generate Credentials For Sync Client

Generate Credentials For Sync Client

This endpoint is responsible for the generating token/secret for a sync client and returning the new token/secret

Request
URI
POST
https://{api_host}//usergroup/t/{TENANT}/broker/directories/{id}/sync-client
COPY
Path Parameters
string
id
Required

Id of the directory.

string
TENANT
Required

TENANT

Query Parameters
string
action
Required

Requested action. Allowed values are ["generate_credentials"]


Request Body
BrokerSyncClientConfigurationMedia of type(s) application/vnd.vmware.vidm.usergroup.broker.directory.syncclientconfiguration+json
Optional
{
    "_links": {
        "self": {
            "href": "https://example.com/path-to-self"
        }
    },
    "generate_token": true,
    "client_id": "my-oauth-grant-client1",
    "client_secret": "my-oauth-grant-client1-secret",
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9xxxxHVcA76zjsGN2w",
    "access_token_expire_in": 21599,
    "token_ttl": 1800
}
object
_links
Optional

The resource HATEOAS links. Usually includes a "self" link for this resource

boolean
generate_token
Optional

Flag that identify if the sync client require an access token or a id/secret credentials. If true, an access token will be generated and the response will include 'access_token' and 'access_token_expiry'. If false, the response will include 'client_id' and 'client_secret' for the sync client. For an existing sync client, if no value is specified the previously saved value will be used.

string
client_id
Optional

OAuth 2.0 Client identifier that the client uses to identify itself during the OAuth2 exchanges.

string
client_secret
Optional

OAuth 2.0 Client secret

string
access_token
Optional

This token can be used to call VMware Identity Manager APIs. The access token is a JSON web token (JWT).

integer As int64 As int64
access_token_expire_in
Optional

The time (in seconds) this token expires. If the return value is positive, the access token is going to expire in that many seconds. If the return value is 0, the access token already expired.

integer As int32 As int32
token_ttl
Optional

How long in minutes new access tokens issued to this client should live. For an existing sync client, if no value is specified the previously saved value will be used.

Authentication
This operation uses the following authentication methods.
Responses
200

Sync client's token/secret is generated

Returns BrokerSyncClientConfigurationMedia of type(s) application/vnd.vmware.vidm.usergroup.broker.directory.syncclientconfiguration+json
{
    "_links": {
        "self": {
            "href": "https://example.com/path-to-self"
        }
    },
    "generate_token": true,
    "client_id": "my-oauth-grant-client1",
    "client_secret": "my-oauth-grant-client1-secret",
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9xxxxHVcA76zjsGN2w",
    "access_token_expire_in": 21599,
    "token_ttl": 1800
}
object
_links
Optional

The resource HATEOAS links. Usually includes a "self" link for this resource

boolean
generate_token
Optional

Flag that identify if the sync client require an access token or a id/secret credentials. If true, an access token will be generated and the response will include 'access_token' and 'access_token_expiry'. If false, the response will include 'client_id' and 'client_secret' for the sync client. For an existing sync client, if no value is specified the previously saved value will be used.

string
client_id
Optional

OAuth 2.0 Client identifier that the client uses to identify itself during the OAuth2 exchanges.

string
client_secret
Optional

OAuth 2.0 Client secret

string
access_token
Optional

This token can be used to call VMware Identity Manager APIs. The access token is a JSON web token (JWT).

integer As int64 As int64
access_token_expire_in
Optional

The time (in seconds) this token expires. If the return value is positive, the access token is going to expire in that many seconds. If the return value is 0, the access token already expired.

integer As int32 As int32
token_ttl
Optional

How long in minutes new access tokens issued to this client should live. For an existing sync client, if no value is specified the previously saved value will be used.


400

Invalid parameters for the generate credentials request.

Operation doesn't return any data structure

401

Unauthorized to generate credentials for the sync client.

Operation doesn't return any data structure

403

Forbidden to generate credentials for the sync client.

Operation doesn't return any data structure

404

The sync client configuration not found for the directory.

Operation doesn't return any data structure

409

More than one sync client configuration was found for the directory.

Operation doesn't return any data structure