Policies

Retrieve information about the current caller

GET

https://ditto.eclipseprojects.io/api/2/whoami

Get information about the current caller, e.g. the auth subjects that are generated for the caller.

curl -X GET 'https://ditto.eclipseprojects.io/api/2/whoami' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch('https://ditto.eclipseprojects.io/api/2/whoami', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
  },
});

const data = await response.text();

import requests

response = requests.get(
    'https://ditto.eclipseprojects.io/api/2/whoami',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
    },
)
print(response.text)

{
  "defaultSubject": "string",
  "subjects": [
    "string"
  ]
}

{
  "status": 0,
  "error": "string",
  "message": "string",
  "description": "string",
  "href": "string"
}

Response

200OKWhoAmI

The request successfully returned information about the caller.

Response fields application/json

Contains information about the current user and the auth subjects available for the used authentication.

defaultSubjectWhoAmISubject

An auth subject that can be used to provide access for a caller (e.g. in subject entries of policies).

subjectsArray<WhoAmISubject>

401UnauthorizedAdvancedError

The request could not be completed due to missing authentication.

Response fields application/json

statusintegerrequired

The HTTP status of the error

errorstringrequired

The error code of the occurred exception

messagestringrequired

The message of the error - what went wrong

descriptionstring

A description how to fix the error or more details

hrefstring

A link to further information about the error and how to fix it

Authorization

OpenIDConnectopenIdConnect

OpenID Connect Discovery URL. The placeholder is replaced by Swagger UI when configured.

NginxBasichttp (basic)

Eclipse Ditto sandbox demo user (demo1 ... demo9) + password (demo)

Bearerhttp (bearer)

A JSON Web Token issued by a supported OAuth 2.0 Identity Provider.

Docs by Sourcey