Client Registration

Register clients.

Read all client registrations.

get

/rest/auth/v1/rest/auth/v1/platform

/clients

Read all clients registrations available in your Collibra instance.

This endpoint is proprietary, rather than part of the OAuth 2.0 family of standards.

Responses

200

Client registrations retrieved successfully

application/json

Client registrations found.

get/clients

HTTPcURLJavaScriptPython

GET /rest/auth/v1/clients HTTP/1.1
Accept: */*

200

Client registrations retrieved successfully

{
  "registrations": [
    {
      "client_id": "text",
      "client_name": "text",
      "client_id_issued_at": 1,
      "grant_types": [
        "text"
      ],
      "redirect_uris": [
        "https://example.com"
      ]
    }
  ]
}

Register client

post

/rest/auth/v1/rest/auth/v1/platform

/clients

Register a client installed at your premises.

Collibra assigns the registered client a unique client identifier, assigns a client secret, and associates the metadata provided in the request to the registered client.

Body

application/json

Request to register a new client.

client_namestringRequired

Descriptive name of the client.

Two different clients cannot have the same name.

This should be a name that reveals the purpose of the client.

Example: Techlin Harvester (us-west-1)

grant_typesstring[]Optional

Authorization grants that the client is allowed to use.

redirect_urisstring · uri[]Optional

Redirection URI strings for use in the authorization code flow. Required when the client intends to use the authorization_code grant type.

software_idstringOptional

Identifier of the Collibra software bundle that implements the client.

Example: datalineage-harvester

Responses

201

Client registered successfully

application/json

Data associated to the registered client.

The client secret returned in this response cannot be read through any API call. Thus you should store the client secret returned in this response.

client_idstringOptional

Technical client identifier returned by the Authorization Server when the client is registered.

client_id_issued_atinteger · int64Optional

Time at which the client identifier was issued.

The time is represented as the number of seconds from 1970-01-01T00:00:00Z as measured in UTC until the date/time of issuance.

client_namestringOptional

Descriptive name of the client.

Two different clients cannot have the same name.

This should be a name that reveals the purpose of the client.

Example: Techlin Harvester (us-west-1)

grant_typesstring[]Optional

Authorization grants that the client is allowed to use.

redirect_urisstring · uri[]Optional

Redirection URI strings for use in the authorization code flow. Required when the client intends to use the authorization_code grant type.

client_secretstring · passwordOptional

Secret generated by Collibra for the registered client.

400

Client registration request is invalid

application/json

post/clients

HTTPcURLJavaScriptPython

POST /rest/auth/v1/clients HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "software_id": "datalineage-harvester",
  "client_name": "Techlin Harvester (us-west-1)",
  "grant_types": [
    "text"
  ],
  "redirect_uris": [
    "https://example.com"
  ]
}

{
  "client_secret": "password",
  "client_id": "text",
  "client_id_issued_at": 1,
  "client_name": "Techlin Harvester (us-west-1)",
  "grant_types": [
    "text"
  ],
  "redirect_uris": [
    "https://example.com"
  ]
}