Authlete
|
Authlete API. More...
Public Member Functions | |
Task< AuthorizationResponse > | Authorization (AuthorizationRequest request) |
Call Authlete's /api/auth/authorization API. More... | |
Task< AuthorizationFailResponse > | AuthorizationFail (AuthorizationFailRequest request) |
Call Authlete's /api/auth/authorization/fail API. More... | |
Task< AuthorizationIssueResponse > | AuthorizationIssue (AuthorizationIssueRequest request) |
Call Authlete's /api/auth/authorization/issue API. More... | |
Task< TokenResponse > | Token (TokenRequest request) |
Call Authlete's /api/auth/token API. More... | |
Task< TokenCreateResponse > | TokenCreate (TokenCreateRequest request) |
Call Authlete's /api/auth/token/create API. More... | |
Task< object > | TokenDelete (string token) |
Delete an access token (= call Authlete's /api/auth/token/delete/{token} API). More... | |
Task< TokenFailResponse > | TokenFail (TokenFailRequest request) |
Call Authlete's /api/auth/token/fail API. More... | |
Task< TokenIssueResponse > | TokenIssue (TokenIssueRequest request) |
Call Authlete's /api/auth/token/issue API. More... | |
Task< TokenUpdateResponse > | TokenUpdate (TokenUpdateRequest request) |
Call Authlete's /api/auth/token/update API. More... | |
Task< RevocationResponse > | Revocation (RevocationRequest request) |
Call Authlete's /api/auth/revocation API. More... | |
Task< UserInfoResponse > | UserInfo (UserInfoRequest request) |
Call Authlete's /api/auth/userinfo API. More... | |
Task< UserInfoIssueResponse > | UserInfoIssue (UserInfoIssueRequest request) |
Call Authlete's /api/auth/userinfo/issue API. More... | |
Task< IntrospectionResponse > | Introspection (IntrospectionRequest request) |
Call Authlete's /api/auth/introspection API. More... | |
Task< StandardIntrospectionResponse > | StandardIntrospection (StandardIntrospectionRequest request) |
Call Authlete's /api/auth/introspection/standard API. More... | |
Task< Service > | CreateService (Service service) |
Create a service (= call Authlete's /api/service/create API). More... | |
Task< object > | DeleteService (long apiKey) |
Delete a service (call Authlete's /api/service/delete/{apiKey} API). More... | |
Task< Service > | GetService (long apiKey) |
Get information about a service (= call Authlete's /api/service/get/{apiKey} API). More... | |
Task< ServiceListResponse > | GetServiceList () |
Get a list of services that belong to the service owner (= call Authlete's /api/service/get/list API). More... | |
Task< ServiceListResponse > | GetServiceList (int start, int end) |
Get a list of services that belong to the service owner (= call Authlete's /api/service/get/list API). More... | |
Task< Service > | UpdateService (Service service) |
Update a service (= call Authlete's /api/service/update/{apiKey} API). More... | |
Task< string > | GetServiceJwks () |
Get the JWK Set of a service (= call Authlete's /api/service/jwks/get API). More... | |
Task< string > | GetServiceJwks (bool pretty, bool includePrivateKeys) |
Get the JWK Set of a service (= call Authlete's /api/service/jwks/get API). More... | |
Task< string > | GetServiceConfiguration () |
Get the configuration of the service in JSON format that complies with OpenID Connect Discovery 1.0. More... | |
Task< string > | GetServiceConfiguration (bool pretty) |
Get the configuration of the service in JSON format that complies with OpenID Connect Discovery 1.0 (= call Authlete's /api/service/configuration API). More... | |
Task< Client > | CreateClient (Client client) |
Create a client (= call Authlete's /api/client/create API). More... | |
Task< object > | DeleteClient (long clientId) |
Delete a client (= call Authlete's /api/client/delete/{clientId} API). More... | |
Task< Client > | GetClient (long clientId) |
Get information about a client (= call Authlete's /api/client/get/{clientId} API). More... | |
Task< ClientListResponse > | GetClientList () |
Get a list of clients that belong to the service (= call Authlete's /api/client/get/list API). More... | |
Task< ClientListResponse > | GetClientList (string developer) |
Get a list of clients that belong to the developer (= call Authlete's /api/client/get/list API). More... | |
Task< ClientListResponse > | GetClientList (int start, int end) |
Get a list of clients that belong to the service (= call Authlete's /api/client/get/list API). More... | |
Task< ClientListResponse > | GetClientList (string developer, int start, int end) |
Get a list of clients (= call Authlete's /api/client/get/list API). More... | |
Task< Client > | UpdateClient (Client client) |
Update a client (= call Authlete's /api/client/update/{clientId} API). More... | |
Task< GrantedScopesGetResponse > | GetGrantedScopes (long clientId, string subject) |
Get the set of scopes that an end-user has granted to a client application (= call Authlete's /api/client/granted_scopes/get/{clientId} API). More... | |
Task< ApiResponse > | DeleteGrantedScopes (long clientId, string subject) |
Delete DB records about the set of scopes that an end-user has granted to a client application (= call Authlete's /api/client/granted_scopes/delete/{clientId} API). More... | |
Task< ApiResponse > | DeleteClientAuthorization (long clientId, string subject) |
Delete all existing access tokens issued to the client application by the end-user (= call Authlete's /api/client/authorization/delete/{clientId} API). More... | |
Task< AuthorizedClientListResponse > | GetClientAuthorizationList (ClientAuthorizationGetListRequest request) |
Get the list of client applications authorized by the end-user (= call Authlete's /api/client/authorization/get/list API). More... | |
Task< ApiResponse > | UpdateClientAuthorization (long clientId, ClientAuthorizationUpdateRequest request) |
Update attributes of all existing access tokens issued to the client application by the end-user (= call Authlete's /api/client/authorization/update/{clientId} API). More... | |
Task< ClientSecretRefreshResponse > | RefreshClientSecret (long clientId) |
Refresh the client secret of a client (= call Authlete's /api/client/secret/refresh/{clientId} API). A new value of the client secret will be generated by the Authlete server. If you want to specify a new value, use UpdateClientSecret method. More... | |
Task< ClientSecretRefreshResponse > | RefreshClientSecret (string clientIdentifier) |
Refresh the client secret of a client (= call Authlete's /api/client/secret/refresh/{clientId} API). A new value of the client secret will be generated by the Authlete server. If you want to specify a new value, use UpdateClientSecret method. More... | |
Task< ClientSecretUpdateResponse > | UpdateClientSecret (long clientId, string clientSecret) |
Update the client secret of a client (= call Authlete's /api/client/secret/update/{clientId} API). If you want to have the Authlete server generate a new value of the client secret, use RefreshClientSecret method. More... | |
Task< ClientSecretUpdateResponse > | UpdateClientSecret (string clientIdentifier, string clientSecret) |
Update the client secret of a client (= call Authlete's /api/client/secret/update/{clientId} API). If you want to have the Authlete server generate a new value of the client secret, use RefreshClientSecret method. More... | |
Task< BackchannelAuthenticationResponse > | BackchannelAuthentication (BackchannelAuthenticationRequest request) |
Call Authlete's /api/backchannel/authentication API. More... | |
Task< BackchannelAuthenticationIssueResponse > | BackchannelAuthenticationIssue (BackchannelAuthenticationIssueRequest request) |
Call Authlete's /api/backchannel/authentication/issue API. More... | |
Task< BackchannelAuthenticationFailResponse > | BackchannelAuthenticationFail (BackchannelAuthenticationFailRequest request) |
Call Authlete's /api/backchannel/authentication/fail API. More... | |
Task< BackchannelAuthenticationCompleteResponse > | BackchannelAuthenticationComplete (BackchannelAuthenticationCompleteRequest request) |
Call Authlete's /api/backchannel/authentication/complete API. More... | |
Task< DeviceAuthorizationResponse > | DeviceAuthorization (DeviceAuthorizationRequest request) |
Call Authlete's /api/device/authorization API. More... | |
Task< DeviceCompleteResponse > | DeviceComplete (DeviceCompleteRequest request) |
Call Authlete's /api/device/complete API. More... | |
Task< DeviceVerificationResponse > | DeviceVerification (DeviceVerificationRequest request) |
Call Authlete's /api/device/verification API. More... | |
Task< PushedAuthReqResponse > | PushAuthorizationRequest (PushedAuthReqRequest request) |
Call Authlete's /api/pushed_auth_req API. More... | |
Properties | |
ISettings | Settings [get] |
The reference to the settings of this IAuthleteApi implementation. More... | |
Authlete API.
Task<AuthorizationResponse> Authorization | ( | AuthorizationRequest | request | ) |
Call Authlete's /api/auth/authorization
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<AuthorizationFailResponse> AuthorizationFail | ( | AuthorizationFailRequest | request | ) |
Call Authlete's /api/auth/authorization/fail
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<AuthorizationIssueResponse> AuthorizationIssue | ( | AuthorizationIssueRequest | request | ) |
Call Authlete's /api/auth/authorization/issue
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<BackchannelAuthenticationResponse> BackchannelAuthentication | ( | BackchannelAuthenticationRequest | request | ) |
Call Authlete's /api/backchannel/authentication
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<BackchannelAuthenticationCompleteResponse> BackchannelAuthenticationComplete | ( | BackchannelAuthenticationCompleteRequest | request | ) |
Call Authlete's /api/backchannel/authentication/complete
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<BackchannelAuthenticationFailResponse> BackchannelAuthenticationFail | ( | BackchannelAuthenticationFailRequest | request | ) |
Call Authlete's /api/backchannel/authentication/fail
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<BackchannelAuthenticationIssueResponse> BackchannelAuthenticationIssue | ( | BackchannelAuthenticationIssueRequest | request | ) |
Call Authlete's /api/backchannel/authentication/issue
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Create a client (= call Authlete's /api/client/create
API).
client | Information about the client you want to create. |
AuthleteApiException |
Implemented in AuthleteApi.
Create a service (= call Authlete's /api/service/create
API).
service | Information about the service you want to create. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<object> DeleteClient | ( | long | clientId | ) |
Delete a client (= call Authlete's /api/client/delete/{clientId}
API).
clientId | The client ID of the client application you want to delete. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ApiResponse> DeleteClientAuthorization | ( | long | clientId, |
string | subject | ||
) |
Delete all existing access tokens issued to the client application by the end-user (= call Authlete's /api/client/authorization/delete/{clientId}
API).
clientId | Client ID. |
subject | Subject (= unique identifier) of an end-user. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ApiResponse> DeleteGrantedScopes | ( | long | clientId, |
string | subject | ||
) |
Delete DB records about the set of scopes that an end-user has granted to a client application (= call Authlete's /api/client/granted_scopes/delete/{clientId}
API).
Even if you delete records about granted scopes by calling this API, existing access tokens are not deleted and scopes of existing access tokens are not changed.
Please call this method if the end-user identified by the subject is deleted from your system. Otherwise, garbage data continue to exist in the database.
clientId | Client ID. |
subject | Subject (= unique identifier) of an end-user. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<object> DeleteService | ( | long | apiKey | ) |
Delete a service (call Authlete's /api/service/delete/{apiKey}
API).
apiKey | The API key of the service. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<DeviceAuthorizationResponse> DeviceAuthorization | ( | DeviceAuthorizationRequest | request | ) |
Call Authlete's /api/device/authorization
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Since version 1.5.0.
Implemented in AuthleteApi.
Task<DeviceCompleteResponse> DeviceComplete | ( | DeviceCompleteRequest | request | ) |
Call Authlete's /api/device/complete
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Since version 1.5.0.
Implemented in AuthleteApi.
Task<DeviceVerificationResponse> DeviceVerification | ( | DeviceVerificationRequest | request | ) |
Call Authlete's /api/device/verification
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Since version 1.5.0.
Implemented in AuthleteApi.
Task<Client> GetClient | ( | long | clientId | ) |
Get information about a client (= call Authlete's /api/client/get/{clientId}
API).
clientId | The client ID. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<AuthorizedClientListResponse> GetClientAuthorizationList | ( | ClientAuthorizationGetListRequest | request | ) |
Get the list of client applications authorized by the end-user (= call Authlete's /api/client/authorization/get/list
API).
request | Conditions of the query to Authlete's /api/client/authorization/get/list API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientListResponse> GetClientList | ( | ) |
Get a list of clients that belong to the service (= call Authlete's /api/client/get/list
API).
This method uses the default range to limit the result set of the query. Use GetClientList(int, int)
to specify the range explicitly.
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientListResponse> GetClientList | ( | int | start, |
int | end | ||
) |
Get a list of clients that belong to the service (= call Authlete's /api/client/get/list
API).
start | The start index (inclusive) of the result set of the query. Must not be negative. |
end | The end index (exclusive) of the result set of the query. Must not be negative. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientListResponse> GetClientList | ( | string | developer | ) |
Get a list of clients that belong to the developer (= call Authlete's /api/client/get/list
API).
When developer
is null
, a list of client applications that belong to the service is returned.
This method uses the default range to limit the result set of the query. Use GetClientList(string, int, int)
to specify the range explicitly.
developer | The developer of the targeted client applications. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientListResponse> GetClientList | ( | string | developer, |
int | start, | ||
int | end | ||
) |
Get a list of clients (= call Authlete's /api/client/get/list
API).
When developer
is null
, a list of clients that belong to the service is returned. Otherwise, when developer
is not null
, a list of clients that belong to the developer is returned.
The pair of start
and end
parameters denotes the range of the result set of the query. For example, if start
is 5 and end
is 7, the pair makes a range from 5 (inclusive) to 7 (exclusive) and the response will contain (at most) 2 pieces of client information, i.e., information about the 6th and 7th clients (the index starts from 0).
If (end - start)
is equal to or less than 0, ClientListResponse.Clients
method of the response returns null
. But even in such a case, ClientListResponse.TotalCount
method returns the total count. In other words, if you want to get just the total count, you can write the code as shown below.
developer | The developer of the targeted clients, or null to get a list of clients of the entire sive. |
start | The start index (inclusive) of the result set of the query. Must not be negative. |
end | The end index (exclusive) of the result set of the query. Must not be negative. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<GrantedScopesGetResponse> GetGrantedScopes | ( | long | clientId, |
string | subject | ||
) |
Get the set of scopes that an end-user has granted to a client application (= call Authlete's /api/client/granted_scopes/get/{clientId}
API).
A dedicated Authlete server provides a functionality to remember the set of scopes that an end-user has granted to a client application. A remembered set is NOT removed from the database even after all existing access tokens associated with the combination of the client application and the subject have expired. Note that this functionality is not provided by the shared Authlete server.
clientId | Client ID. |
subject | Subject (= unique identifier) of an end-user. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<Service> GetService | ( | long | apiKey | ) |
Get information about a service (= call Authlete's /api/service/get/{apiKey}
API).
apiKey | The API key of the service. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<string> GetServiceConfiguration | ( | ) |
Get the configuration of the service in JSON format that complies with OpenID Connect Discovery 1.0.
This method is an alias of GetServiceConfiguration(true)
AuthleteApiException |
Implemented in AuthleteApi.
Task<string> GetServiceConfiguration | ( | bool | pretty | ) |
Get the configuration of the service in JSON format that complies with OpenID Connect Discovery 1.0 (= call Authlete's /api/service/configuration
API).
The value returned from this method can be used as the response body from /.well-known/openid-configuration
. See 4. Obtaining OpenID Provider Configuration Information of OpenID Connect Discovery 1.0 for details.
pretty | true to get the JSON in pretty format. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<string> GetServiceJwks | ( | ) |
Get the JWK Set of a service (= call Authlete's /api/service/jwks/get
API).
This method is an alias of GetServiceJwks(false, false)
.
AuthleteApiException |
Implemented in AuthleteApi.
Task<string> GetServiceJwks | ( | bool | pretty, |
bool | includePrivateKeys | ||
) |
Get the JWK Set of a service (= call Authlete's /api/service/jwks/get
API).
pretty | true to get the JSON in pretty format. |
includePrivateKeys | true to include private keys in the JSON. false to exclude private keys from the JSON. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ServiceListResponse> GetServiceList | ( | ) |
Get a list of services that belong to the service owner (= call Authlete's /api/service/get/list
API).
This method uses the default range to limit the result set of the query. Use GetServiceList(int, int)
to specify the range explicitly.
AuthleteApiException |
Implemented in AuthleteApi.
Task<ServiceListResponse> GetServiceList | ( | int | start, |
int | end | ||
) |
Get a list of services that belong to the service owner (= call Authlete's /api/service/get/list
API).
The pair of start
and end
parameters denotes the range of the result set of the query. For example, if start
is 5 and end
is 7, the pair makes a range from 5 (inclusive) to 7 (exclusive) and the response will contain (at most) 2 pieces of service information, i.e., information about the 6th and the 7th services (the index starts from 0).
If (end - start)
is equal to or less than 0, ServiceListResponse.Services
method of the response returns null
. But even in such a case, ServiceListResponse.TotalCount
method returns the total count. In other words, if you want to get just the total count, you can write the code as shown below.
start | The start index (inclusive) of the result set of the query. Must not be negative. |
end | The end index (exclusive) of the result set of the query. Must not be negative. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<IntrospectionResponse> Introspection | ( | IntrospectionRequest | request | ) |
Call Authlete's /api/auth/introspection
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<PushedAuthReqResponse> PushAuthorizationRequest | ( | PushedAuthReqRequest | request | ) |
Call Authlete's /api/pushed_auth_req
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Since version 1.5.0.
Implemented in AuthleteApi.
Task<ClientSecretRefreshResponse> RefreshClientSecret | ( | long | clientId | ) |
Refresh the client secret of a client (= call Authlete's /api/client/secret/refresh/{clientId}
API). A new value of the client secret will be generated by the Authlete server. If you want to specify a new value, use UpdateClientSecret
method.
clientId | Client ID. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientSecretRefreshResponse> RefreshClientSecret | ( | string | clientIdentifier | ) |
Refresh the client secret of a client (= call Authlete's /api/client/secret/refresh/{clientId}
API). A new value of the client secret will be generated by the Authlete server. If you want to specify a new value, use UpdateClientSecret
method.
clientIdentifier | Client ID. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<RevocationResponse> Revocation | ( | RevocationRequest | request | ) |
Call Authlete's /api/auth/revocation
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<StandardIntrospectionResponse> StandardIntrospection | ( | StandardIntrospectionRequest | request | ) |
Call Authlete's /api/auth/introspection/standard
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<TokenResponse> Token | ( | TokenRequest | request | ) |
Call Authlete's /api/auth/token
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<TokenCreateResponse> TokenCreate | ( | TokenCreateRequest | request | ) |
Call Authlete's /api/auth/token/create
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<object> TokenDelete | ( | string | token | ) |
Delete an access token (= call Authlete's /api/auth/token/delete/{token}
API).
token | An access token or its hash value. |
AuthleteApiException |
Since version 1.5.0.
Implemented in AuthleteApi.
Task<TokenFailResponse> TokenFail | ( | TokenFailRequest | request | ) |
Call Authlete's /api/auth/token/fail
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<TokenIssueResponse> TokenIssue | ( | TokenIssueRequest | request | ) |
Call Authlete's /api/auth/token/issue
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<TokenUpdateResponse> TokenUpdate | ( | TokenUpdateRequest | request | ) |
Call Authlete's /api/auth/token/update
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Update a client (= call Authlete's /api/client/update/{clientId}
API).
client.ClientId
must return the correct client ID of the client.
client | Information about a client you want to update. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ApiResponse> UpdateClientAuthorization | ( | long | clientId, |
ClientAuthorizationUpdateRequest | request | ||
) |
Update attributes of all existing access tokens issued to the client application by the end-user (= call Authlete's /api/client/authorization/update/{clientId}
API).
clientId | Client ID. |
request | Request. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientSecretUpdateResponse> UpdateClientSecret | ( | long | clientId, |
string | clientSecret | ||
) |
Update the client secret of a client (= call Authlete's /api/client/secret/update/{clientId}
API). If you want to have the Authlete server generate a new value of the client secret, use RefreshClientSecret
method.
Valid characters for a client secret are A-Z
, a-z
, 0-9
, -
, and _
. The maximum length of a client secret is 86.
clientId | Client ID. |
clientSecret | A new value of client secret. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<ClientSecretUpdateResponse> UpdateClientSecret | ( | string | clientIdentifier, |
string | clientSecret | ||
) |
Update the client secret of a client (= call Authlete's /api/client/secret/update/{clientId}
API). If you want to have the Authlete server generate a new value of the client secret, use RefreshClientSecret
method.
Valid characters for a client secret are A-Z
, a-z
, 0-9
, -
, and _
. The maximum length of a client secret is 86.
clientIdentifier | Client ID. |
clientSecret | A new value of client secret. |
AuthleteApiException |
Implemented in AuthleteApi.
Update a service (= call Authlete's /api/service/update/{apiKey}
API).
service.ApiKey
must return the correct API key of the service.
service | Information about a service to update. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<UserInfoResponse> UserInfo | ( | UserInfoRequest | request | ) |
Call Authlete's /api/auth/userinfo
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
Task<UserInfoIssueResponse> UserInfoIssue | ( | UserInfoIssueRequest | request | ) |
Call Authlete's /api/auth/userinfo/issue
API.
request | Request parameters passed to the API. |
AuthleteApiException |
Implemented in AuthleteApi.
|
get |
The reference to the settings of this IAuthleteApi
implementation.