Social Login

Logs an end user in with a Google ID token and returns their authentication token.

Only ID tokens issued by Google are accepted (issuer accounts.google.com). Tokens from any other identity provider are rejected with 401 “ID Token issued by unsupported issuer”. To use your own identity provider for end users, authenticate them in your application and use Delegated Login instead.

The user must have registered with Create Social Registration Challenge. DFNS matches the returning user by the token’s email claim (their DFNS username) and checks that its sub claim matches the Google account used at registration. The response contains only token.

POST /auth/login/social

Social Login

cURL

curl --request POST \
  --url https://api.dfns.io/auth/login/social \
  --header 'Content-Type: application/json' \
  --data '
{
  "socialLoginProviderKind": "Oidc",
  "idToken": "<string>",
  "orgId": "or-30tnh-itmjs-s235s5ontr3r23h2"
}
'

200

{
  "token": "<string>",
  "expiry": 123,
  "identity": {
    "userId": "<string>",
    "username": "<string>",
    "orgId": "<string>",
    "tenantId": "<string>"
  }
}

​

Authentication

No authentication required.

​

Required Permissions

No authentication required.

Body

application/json

socialLoginProviderKind · enum<string> · required

Social login provider used to issue the JWT.

Available options: Oidc

idToken · string · required

JWT id token issued by the social login provider.

orgId · string

Organization id.

Required string length: 1 - 64

Pattern: ^or-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"or-30tnh-itmjs-s235s5ontr3r23h2"

Response

200 - application/json

Success

token · string · required

Authentication token issued to the user.

expiry · number

Token expiration time in epoch milliseconds.

identity · object

Decoded identity for the issued token. Populated for flows whose token is not a Dfns-minted JWT (e.g. OIDC passthrough) so clients can skip JWT decoding; absent on flows where the token's claims carry the same fields.

Show child attributes