Skip to content
This repository has been archived by the owner on Apr 27, 2021. It is now read-only.

API Reference Models

VSTS System User edited this page May 20, 2019 · 14 revisions

Definitions

Fabric.Identity.API.Models.ApiResource

Name Description Schema
apiSecret
optional
The API secret is used for the introspection endpoint. The API can authenticate
with introspection using the API name and secret.
string
description
optional
Description of the resource. string
displayName
optional
Display name of the resource. string
enabled
optional
Indicates if this resource is enabled. Defaults to true.
Default : true
boolean
name
required
The unique name of the resource. Required in the request body ONLY for POST operations. string
scopes
required
An API must have at least one scope. Each scope can have different settings. < Fabric.Identity.API.Models.Scope > array
userClaims
required
List of accociated user claims that should be included when this resource is requested. < string > array

Fabric.Identity.API.Models.Client

http://docs.identityserver.io/en/release/reference/client.html

Name Description Schema
absoluteRefreshTokenLifetime
optional
Maximum lifetime of a refresh token in seconds. Defaults to 2592000 seconds / 30 days.
Default : 259200
integer (int32)
accessTokenLifetime
optional
Lifetime of access token in seconds (defaults to 3600 seconds / 1 hour).
Default : 3600
integer (int32)
accessTokenType
optional
Specifies whether the access token is a reference token or a self contained JWT
token (defaults to Jwt).
Default : "Jwt"
enum (Jwt, Reference)
allowAccessTokensViaBrowser
optional
Controls whether access tokens are transmitted via the browser for this client
(defaults to false). This can prevent accidental leakage of access tokens when
multiple response types are allowed.
boolean
allowOfflineAccess
required
Indicates whether the client can request refresh tokens (not allowed for implicit or password grant types). boolean
allowPlainTextPkce
optional
Specifies whether a proof key can be sent using plain method (not recommended
and default to false).
boolean
allowRememberConsent
optional
Specifies whether user can choose to store consent decisions (defaults to true).
Default : true
boolean
allowedCorsOrigins
optional
Gets or sets the allowed CORS origins for JavaScript clients. < string > array
allowedGrantTypes
required
Supported grant types for this client.
Valid options include the following:
implicit | hybrid | authorization_code | client_credentials | password | delegation | delegation, client_credentials
< string > array
allowedScopes
required
Specifies the API scopes that the client is allowed to request. If empty, the
client can't access any scope.
< string > array
alwaysIncludeUserClaimsInIdToken
optional
When requesting both an id token and access token, should the user claims always be
added to the id token instead of requring the client to use the userinfo endpoint.
boolean
alwaysSendClientClaims
optional
Gets or sets a value indicating whether client claims should be always included
in the access tokens - only for client credentials flow.
boolean
authorizationCodeLifetime
optional
Lifetime of authorization code in seconds (defaults to 300 seconds / 5 minutes).
Default : 300
integer (int32)
claims
optional
Allows settings claims for the client (will be included in the access token). < System.Security.Claims.Claim > array
clientId
required
Unique client ID. Required in the request body ONLY for POST operations. string
clientName
required
Client display name (used for logging and consent screen). string
clientSecret
optional
Client secrets - only relevant for flows that require a secret. string
clientUri
optional
URI for further information about client (used on consent screen). string
enableLocalLogin
optional
Gets or sets a value indicating whether the local login is allowed for this client.
Defaults to true.
Default : true
boolean
enabled
optional
Specifies if client is enabled (defaults to true).
Default : true
boolean
identityProviderRestrictions
optional
Specifies which external IdPs can be used with this client (if list is
empty all IdPs are allowed). Defaults to empty.
< string > array
identityTokenLifetime
optional
Lifetime of identity token in seconds (defaults to 300 seconds / 5 minutes).
Default : 300
integer (int32)
includeJwtId
optional
Gets or sets a value indicating whether JWT access tokens should include an identifier. boolean
logoUri
optional
URI to client logo (used on consent screen). string
logoutSessionRequired
optional
Specifies is the user's session id should be sent to the LogoutUri.
Defaults to true.
Default : true
boolean
logoutUri
optional
Specifies logout URI at client for HTTP based logout. string
postLogoutRedirectUris
optional
Specifies allowed URIs to redirect to after logout. < string > array
prefixClientClaims
optional
Gets or sets a value indicating whether all client claims should be prefixed.
Default : true
boolean
protocolType
optional
Gets or sets the protocol type. Defaults to "oidc".
Default : "oidc"
string
redirectUris
optional
Specifies allowed URIs to return tokens or authorization codes to. < string > array
refreshTokenExpiration
optional
Absolute: the refresh token will expire on a fixed point in time (specified by
the AbsoluteRefreshTokenLifetime) Sliding: when refreshing the token, the lifetime of
the refresh token will be renewed (by the amount specified in SlidingRefreshTokenLifetime).
The lifetime will not exceed AbsoluteRefreshTokenLifetime.
Default : "Absolute"
enum (Sliding, Absolute)
refreshTokenUsage
optional
ReUse: the refresh token handle will stay the same when refreshing tokens
OneTime: the refresh token handle will be updated when refreshing tokens
Default : "OneTimeOnly"
enum (ReUse, OneTimeOnly)
requireClientSecret
optional
If set to false, no client secret is needed to request tokens at the token endpoint (defaults to true).
Default : true
boolean
requireConsent
optional
Specifies whether a consent screen is required (defaults to true).
Default : true
boolean
requirePkce
optional
Specifies whether a proof key is required for authorization code based token requests. boolean
slidingRefreshTokenLifetime
optional
Sliding lifetime of a refresh token in seconds. Defaults to 1296000 seconds / 15 days.
Default : 1296000
integer (int32)
updateAccessTokenClaimsOnRefresh
optional
Gets or sets a value indicating whether the access token (and its claims)
should be updated on a refresh token request.
boolean

Fabric.Identity.API.Models.Error

Name Schema
code
optional
string
details
optional
< Fabric.Identity.API.Models.Error > array
innererror
optional
Fabric.Identity.API.Models.InnerError
message
optional
string
target
optional
string

Fabric.Identity.API.Models.ExternalProviderApiModel

Name Schema
authenticationScheme
optional
string
displayName
optional
string

Fabric.Identity.API.Models.IdentityResource

Name Description Schema
description
optional
Description of the resource. string
displayName
optional
Display name of the resource. string
emphasize
optional
Specifies whether the consent screen will emphasize this scope (if the consent screen
wants to implement such a feature). Use this setting for sensitive or important scopes.
Defaults to false.
boolean
enabled
optional
Indicates if this resource is enabled. Defaults to true.
Default : true
boolean
name
required
The unique name of the resource. Required in the request body ONLY for POST operations. string
required
optional
Specifies whether the user can de-select the scope on the consent screen (if
the consent screen wants to implement such a feature). Defaults to false.
boolean
showInDiscoveryDocument
optional
Specifies whether this scope is shown in the discovery document. Defaults to true.
Default : true
boolean
userClaims
required
List of accociated user claims that should be included when this resource is requested. < string > array

Fabric.Identity.API.Models.InnerError

Name Schema
code
optional
string
innererror
optional
Fabric.Identity.API.Models.InnerError

Fabric.Identity.API.Models.Scope

Name Description Schema
description
optional
Description. This value will be used e.g. on the consent screen. string
displayName
optional
Display name. This value will be used e.g. on the consent screen. string
emphasize
optional
Specifies whether the consent screen will emphasize this scope. Use this setting
for sensitive or important scopes. Defaults to false.
boolean
name
required
Name of the scope. This is the value a client will use to request the scope. string
required
optional
Specifies whether the user can de-select the scope on the consent screen.
Defaults to false.
boolean
showInDiscoveryDocument
optional
Specifies whether this scope is shown in the discovery document. Defaults to true.
Default : true
boolean
userClaims
optional
List of user claims that should be included in the access token. < string > array

Fabric.Identity.API.Models.UserApiModel

Name Schema
email
optional
string
firstName
optional
string
lastLoginDate
optional
string (date-time)
lastName
optional
string
middleName
optional
string
subjectId
optional
string

Fabric.Identity.API.Models.UserSearchParameter

Name Schema
clientId
optional
string
userIds
optional
< string > array

System.Security.Claims.Claim

Name Schema
issuer
optional
read-only
string
originalIssuer
optional
read-only
string
properties
optional
< string, string > map
subject
optional
System.Security.Claims.ClaimsIdentity
type
optional
read-only
string
value
optional
read-only
string
valueType
optional
read-only
string

System.Security.Claims.ClaimsIdentity

Name Schema
actor
optional
System.Security.Claims.ClaimsIdentity
authenticationType
optional
read-only
string
bootstrapContext
optional
object
claims
optional
< System.Security.Claims.Claim > array
isAuthenticated
optional
read-only
boolean
label
optional
string
name
optional
read-only
string
nameClaimType
optional
read-only
string
roleClaimType
optional
read-only
string
Clone this wiki locally