adminschema

package
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 30, 2016 License: Apache-2.0 Imports: 12 Imported by: 0

README

Dex Admin API

The Dex Admin API.

Version: v1

Models

Admin
{
    email: string,
    id: string,
    password: string
}
Client
{
    clientName: string // OPTIONAL for normal cliens. 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 ). REQUIRED for public clients,
    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. If specified in a client create request, it will be used as the ID. Otherwise, the server will choose the ID.,
    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 ) .,
    public: boolean // OPTIONAL. Determines if the client is public. Public clients have certain restrictions: They cannot use their credentials to obtain a client JWT. Their redirects URLs cannot be specified: they are always http://localhost:$PORT or urn:ietf:wg:oauth:2.0:oob.,
    redirectURIs: [
        string
    ],
    secret: string // The client secret. If specified in a client create request, it will be used as the secret. Otherwise, the server will choose the secret. Must be a base64 URLEncoded string.,
    trustedPeers: [
        string
    ]
}
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
}
Connector

An object which describes a federating identity strategy. For documentation see Documentation/connectors-configuration.md. Since different connectors expect different object fields the scheme is omitted here.


ConnectorsGetResponse

A list of all connector responses.

{
    connectors: [
        Connector
    ]
}
ConnectorsSetRequest

A request to set all the connectors in the dex database.

{
    connectors: [
        Connector
    ]
}
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 /connectors

Summary

Get Connectors

Description

Return a list of the connectors for the dex system.

Responses

|Code|Description|Type| |:-----|:-----|:-----| | 200 | | ConnectorsGetResponse | | default | Unexpected error | |

PUT /connectors

Summary

Set Connectors

Description

Set the list of connectors for the dex system, overwriting all previous connectors. A 200 status code indicates the action was successful.

Parameters

|Name|Located in|Description|Required|Type| |:-----|:-----|:-----|:-----|:-----| | | body | | Yes | ConnectorsSetRequest |

Responses

|Code|Description|Type| |:-----|:-----|:-----| | 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 | |

Documentation

Overview

Package adminschema provides access to the Dex Admin API.

See http://github.com/coreos/dex

Usage example:

import "google.golang.org/api/adminschema/v1"
...
adminschemaService, err := adminschema.New(oauthHttpClient)

Index

Constants

View Source
const DiscoveryJSON = `` /* 7819-byte string literal not displayed */

This file is automatically generated by schema/generator

**** DO NOT EDIT ****

Variables

View Source
var (
	ErrorNoRedirectURI      = errors.New("No Redirect URIs")
	ErrorInvalidRedirectURI = errors.New("Invalid Redirect URI")
	ErrorInvalidLogoURI     = errors.New("Invalid Logo URI")
	ErrorInvalidClientURI   = errors.New("Invalid Client URI")
)

Functions

func MapSchemaClientToClient added in v0.4.0

func MapSchemaClientToClient(sc Client) (client.Client, error)

Types

type Admin

type Admin struct {
	Email string `json:"email,omitempty"`

	Id string `json:"id,omitempty"`

	Password string `json:"password,omitempty"`
}

type AdminCreateCall

type AdminCreateCall struct {
	// contains filtered or unexported fields
}

func (*AdminCreateCall) Do

func (c *AdminCreateCall) Do() (*Admin, error)

func (*AdminCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type AdminGetCall

type AdminGetCall struct {
	// contains filtered or unexported fields
}

func (*AdminGetCall) Do

func (c *AdminGetCall) Do() (*Admin, error)

func (*AdminGetCall) Fields

func (c *AdminGetCall) Fields(s ...googleapi.Field) *AdminGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type AdminService

type AdminService struct {
	// contains filtered or unexported fields
}

func NewAdminService

func NewAdminService(s *Service) *AdminService

func (*AdminService) Create

func (r *AdminService) Create(admin *Admin) *AdminCreateCall

Create: Create a new admin user.

func (*AdminService) Get

func (r *AdminService) Get(id string) *AdminGetCall

Get: Retrieve information about an admin user.

type Client added in v0.4.0

type Client struct {
	// ClientName: OPTIONAL for normal cliens. 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 ). REQUIRED for public
	// clients
	ClientName string `json:"clientName,omitempty"`

	// ClientURI: 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 ) .
	ClientURI string `json:"clientURI,omitempty"`

	// Id: The client ID. If specified in a client create request, it will
	// be used as the ID. Otherwise, the server will choose the ID.
	Id string `json:"id,omitempty"`

	IsAdmin bool `json:"isAdmin,omitempty"`

	// LogoURI: 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 ) .
	LogoURI string `json:"logoURI,omitempty"`

	// Public: OPTIONAL. Determines if the client is public. Public clients
	// have certain restrictions: They cannot use their credentials to
	// obtain a client JWT. Their redirects URLs cannot be specified: they
	// are always http://localhost:$PORT or urn:ietf:wg:oauth:2.0:oob.
	Public bool `json:"public,omitempty"`

	// RedirectURIs: REQUIRED for normal clients. Array of Redirection URI
	// values used by the Client. One of these registered Redirection URI
	// values MUST exactly match the redirect_uri parameter value used in
	// each Authorization Request, with the matching performed as described
	// in Section 6.2.1 of [RFC3986] ( Berners-Lee, T., Fielding, R., and L.
	// Masinter, “Uniform Resource Identifier (URI): Generic Syntax,”
	// January 2005. ) (Simple String Comparison). DISALLOWED for public
	// clients.
	RedirectURIs []string `json:"redirectURIs,omitempty"`

	// Secret: The client secret. If specified in a client create request,
	// it will be used as the secret. Otherwise, the server will choose the
	// secret. Must be a base64 URLEncoded string.
	Secret string `json:"secret,omitempty"`

	// TrustedPeers: Array of ClientIDs of clients that are allowed to mint
	// ID tokens for the client being created.
	TrustedPeers []string `json:"trustedPeers,omitempty"`
}

func MapClientToSchemaClient added in v0.4.0

func MapClientToSchemaClient(c client.Client) Client

type ClientCreateCall added in v0.4.0

type ClientCreateCall struct {
	// contains filtered or unexported fields
}

func (*ClientCreateCall) Do added in v0.4.0

func (*ClientCreateCall) Fields added in v0.4.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type ClientCreateRequest added in v0.4.0

type ClientCreateRequest struct {
	Client *Client `json:"client,omitempty"`
}

type ClientCreateResponse added in v0.4.0

type ClientCreateResponse struct {
	Client *Client `json:"client,omitempty"`
}

type ClientService added in v0.4.0

type ClientService struct {
	// contains filtered or unexported fields
}

func NewClientService added in v0.4.0

func NewClientService(s *Service) *ClientService

func (*ClientService) Create added in v0.4.0

func (r *ClientService) Create(clientcreaterequest *ClientCreateRequest) *ClientCreateCall

Create: Register an OpenID Connect client.

type Connector added in v0.5.0

type Connector interface{}

type ConnectorsGetCall added in v0.5.0

type ConnectorsGetCall struct {
	// contains filtered or unexported fields
}

func (*ConnectorsGetCall) Do added in v0.5.0

func (*ConnectorsGetCall) Fields added in v0.5.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type ConnectorsGetResponse added in v0.5.0

type ConnectorsGetResponse struct {
	Connectors []interface{} `json:"connectors,omitempty"`
}

type ConnectorsService added in v0.5.0

type ConnectorsService struct {
	// contains filtered or unexported fields
}

func NewConnectorsService added in v0.5.0

func NewConnectorsService(s *Service) *ConnectorsService

func (*ConnectorsService) Get added in v0.5.0

Get: Return a list of the connectors for the dex system.

func (*ConnectorsService) Set added in v0.5.0

func (r *ConnectorsService) Set(connectorssetrequest *ConnectorsSetRequest) *ConnectorsSetCall

Set: Set the list of connectors for the dex system, overwriting all previous connectors. A 200 status code indicates the action was successful.

type ConnectorsSetCall added in v0.5.0

type ConnectorsSetCall struct {
	// contains filtered or unexported fields
}

func (*ConnectorsSetCall) Do added in v0.5.0

func (c *ConnectorsSetCall) Do() error

func (*ConnectorsSetCall) Fields added in v0.5.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type ConnectorsSetRequest added in v0.5.0

type ConnectorsSetRequest struct {
	Connectors []interface{} `json:"connectors,omitempty"`
}

type Service

type Service struct {
	BasePath string // API endpoint base URL

	Admin *AdminService

	Client *ClientService

	Connectors *ConnectorsService

	State *StateService
	// contains filtered or unexported fields
}

func New

func New(client *http.Client) (*Service, error)

func NewWithBasePath

func NewWithBasePath(client *http.Client, basePath string) (*Service, error)

type State

type State struct {
	AdminUserCreated bool `json:"AdminUserCreated,omitempty"`
}

type StateGetCall

type StateGetCall struct {
	// contains filtered or unexported fields
}

func (*StateGetCall) Do

func (c *StateGetCall) Do() (*State, error)

func (*StateGetCall) Fields

func (c *StateGetCall) Fields(s ...googleapi.Field) *StateGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

type StateService

type StateService struct {
	// contains filtered or unexported fields
}

func NewStateService

func NewStateService(s *Service) *StateService

func (*StateService) Get

func (r *StateService) Get() *StateGetCall

Get: Get the state of the Dex DB

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL