Skip to main content

Overwolf OIDC - Registration

Registration​

To register a new client application with our OIDC service, you need to follow the steps below.

note

Ensure you have received your Authorization Token from your Dev-Rel representative.

Create​

To create your new client, use a POST request to the registration endpoint below:

Request Type: POST
Hostname: https://id.overwolf.com
Path: /oidc/reg
Headers:
    Authorization: 'Bearer ${token}' # Contact your dev-rel to get the registration Authorization token.

Body:
  "redirect_uris": string[],
  "client_name": string,
  "logo_uri": string,
  "policy_uri": string,
  "tos_uri": string,

Response:
  client_id: string,
  client_secret: string,
  registration_client_uri: string # (this is the endpoint to get those details again or update)
  registration_access_token: string # (this is the bearer token to the endpoint above, must save it)
Important
  • registration_client_uri is the endpoint to get your OIDC client details or to update them using the GET and PUT methods below.
  • registration_access_token is the bearer token for the endpoint above, you must save it.

Management​

Use the following endpoints to retrieve or update your current configuration.

Get info​

To retrieve your client details, use a GET request to the registration_client_uri with the following details:

Request Type: GET
Hostname: https://id.overwolf.com
Path: /oidc/reg/{client_id}
Headers:
    Authorization: 'Bearer ${registration_access_token}' # The Authorization token is the registration_access_token from the creation method’s response.
Response

You will receive your client details, similar to the response from the creation method.

Update info​

To update your client configuration, use a PUT request to the to the registration_client_uri with the following details:

Request Type: PUT
Hostname: https://id.overwolf.com
Path: /oidc/reg/{client_id}
Headers:
    Authorization: 'Bearer ${registration_access_token}' # Use the `registration_access_token` from the creation method’s response.

Body:
  "redirect_uris": string[], # Mandatory field
  "client_id": string, # Mandatory field
  "client_name": string, # Mandatory field
  "logo_uri": string, # Mandatory field
  "policy_uri": string, # Mandatory field
  "tos_uri": string, # Mandatory field
Response

The response will be similar to the response from the creation method, but with the updated configuration.