Skip to content

Security and Authorization ​

To ensure the security and privacy of your data, all interactions with Graia CCaaS's endpoints require authentication using OAuth 2.0. This protocol ensures that only authorized applications can access and modify your data.

Here's a high-level overview of the process:

To use the OAuth 2.0 Client Credentials Flow with Graia CCaaS, follow these steps:

  1. Acquire Client ID and Client Secret: Contact your Graia CCaaS representative to obtain your application's client ID and client secret.
  2. Request Access Token: Send a POST request to the Graia CCaaS authorization server endpoint. Include your client ID and client secret in the request.
  3. Receive Access Token: If your application is successfully authenticated, the authorization server will respond with an access token.

Use Access Token: Include this token in the header of your subsequent requests to Graia CCaaS's endpoints. This will authorize your application to access the required resources.

Authorization: Bearer {token}

Discovery endpoint: https://geoauth-prod.geomant.cloud/.well-known/openid-configuration

Required data
Authorityhttps://geoauth-prod.geomant.cloud
Client id<your_client_id>
Client secret<your_client_secret>
Scopebuzzeasy

Security Considerations ​

To ensure the security of your client credentials, treat it as sensitive information. Do not hard-code the client credentials directly into your source code or expose it publicly. Instead, use secure methods to manage and store your client crentials, such as environment variables or configuration files that are excluded from version control.

Example ​

1. (Optional) discover the token endpoint ​

If you want to confirm the exact token URL first:

bash
curl -s https://geoauth-prod.geomant.cloud/.well-known/openid-configuration \
  | jq -r '.token_endpoint'
# → typically returns: https://geoauth-prod.geomant.cloud/connect/token

2. Exchange your client ID/secret for an access token ​

bash
# recommended: keep secrets out of your shell history
export GRAIA_CCAAS_CLIENT_ID="<your_client_id>"
export GRAIA_CCAAS_CLIENT_SECRET="<your_client_secret>"

curl -X POST https://geoauth-prod.geomant.cloud/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "client_id=${GRAIA_CCAAS_CLIENT_ID}" \
  --data-urlencode "client_secret=${GRAIA_CCAAS_CLIENT_SECRET}" \
  --data-urlencode "scope=buzzeasy"

Typical response:

json
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 3600,
  "token_type": "Bearer",
  "scope": "buzzeasy"
}

3. Call a Graia CCaaS-protected endpoint ​

bash
curl -X GET https://api.buzzeasy.com/your-resource/v1/function \
  -H "Authorization: Bearer ${TOKEN}"

That's it! You can now securely access Graia CCaaS's resources using the access token obtained through the OAuth 2.0 Client Credentials Flow.