dex/schema/adminschema/README.md

Dex Admin API

The Dex Admin API.

Version: v1

Models

Admin

{
    email: string,
    id: string,
    password: string
}

Client

{
    clientName: string // OPTIONAL. Name of the Client to be presented to the End-User. If desired, representation of this Claim in different languages and scripts is represented as described in Section 2.1 ( Metadata Languages and Scripts ) .,
    clientURI: string // OPTIONAL. URL of the home page of the Client. The value of this field MUST point to a valid Web page. If present, the server SHOULD display this URL to the End-User in a followable fashion. If desired, representation of this Claim in different languages and scripts is represented as described in Section 2.1 ( Metadata Languages and Scripts ) .,
    id: string // The client ID. Ignored in client create requests.,
    isAdmin: boolean,
    logoURI: string // OPTIONAL. URL that references a logo for the Client application. If present, the server SHOULD display this image to the End-User during approval. The value of this field MUST point to a valid image file. If desired, representation of this Claim in different languages and scripts is represented as described in Section 2.1 ( Metadata Languages and Scripts ) .,
    redirectURIs: [
        string
    ],
    secret: string // The client secret. Ignored in client create requests.
}

ClientCreateRequest

A request to register a client with dex.

{
    client: Client
}

ClientCreateResponse

Upon successful registration, an ID and secret is assigned to the client.

{
    client: Client
}

State

{
    AdminUserCreated: boolean
}

Paths

POST /admin

Summary

Create Admin

Description

Create a new admin user.

Parameters

Name	Located in	Description	Required	Type
	body		Yes	Admin

Responses

Code	Description	Type
200		Admin
default	Unexpected error

GET /admin/{id}

Summary

Get Admin

Description

Retrieve information about an admin user.

Parameters

Name	Located in	Description	Required	Type
id	path		Yes	string

Responses

Code	Description	Type
200		Admin
default	Unexpected error

POST /client

Summary

Create Client

Description

Register an OpenID Connect client.

Parameters

Name	Located in	Description	Required	Type
	body		Yes	ClientCreateRequest

Responses

Code	Description	Type
200		ClientCreateResponse
default	Unexpected error

GET /state

Summary

Get State

Description

Get the state of the Dex DB

Responses

Code	Description	Type
200		State
default	Unexpected error