Vcenter Authentication Token IssueSpec

Vcenter Authentication Token IssueSpec
Vcenter Authentication Token IssueSpec

The Vcenter Authentication Token IssueSpec schema contains arguments required for token exchange.

This schema was added in vSphere API 7.0.2.0.

JSON Example
{
    "grant_type": "string",
    "resource": "string",
    "audience": "string",
    "scope": "string",
    "requested_token_type": "string",
    "subject_token": "string",
    "subject_token_type": "string",
    "actor_token": "string",
    "actor_token_type": "string"
}
string
grant_type
Required

The value of urn:ietf:params:oauth:grant-type:token-exchange indicates that a token exchange is being performed.

This property was added in vSphere API 7.0.2.0.

When clients pass a value of this schema as a parameter, the property must be one of urn:ietf:params:oauth:grant-type:token-exchange. When operations return a value of this schema as a response, the property will be one of urn:ietf:params:oauth:grant-type:token-exchange.

string
resource
Optional

Indicates the location of the target service or resource where the client intends to use the requested security token.

This property was added in vSphere API 7.0.2.0.

If missing or null, it is inferred from other arguments.

string
audience
Optional

The logical name of the target service where the client intends to use the requested security token. This serves a purpose similar to the Vcenter Authentication Token IssueSpec.resource property, but with the client providing a logical name rather than a location.

This property was added in vSphere API 7.0.2.0.

If missing or null, it is inferred from other arguments.

string
scope
Optional

A list of space-delimited, case-sensitive strings, that allow the client to specify the desired scope of the requested security token in the context of the service or resource where the token will be used.

This property was added in vSphere API 7.0.2.0.

If missing or null, it is inferred from other arguments.

string
requested_token_type
Optional

An identifier for the type of the requested security token. If the requested type is unspecified, the issued token type is at the discretion of the server and may be dictated by knowledge of the requirements of the service or resource indicated by the Vcenter Authentication Token IssueSpec.resource or Vcenter Authentication Token IssueSpec.audience property.

This property was added in vSphere API 7.0.2.0.

If missing or null, it is inferred from other arguments.

string
subject_token
Optional

A security token that represents the identity of the party on behalf of whom exchange is being made. Typically, the subject of this token will be the subject of the security token issued. Token is base64-encoded.

The property is required when the value of the Vcenter Authentication Token IssueSpec.grant_type property is urn:ietf:params:oauth:grant-type:token-exchange.

This property was added in vSphere API 7.0.2.0.

This property is currently required. In the future, the schema may support grant-types other than urn:ietf:params:oauth:grant-type:token-exchange for which the value may be missing or null.

string
subject_token_type
Optional

An identifier, that indicates the type of the security token in the Vcenter Authentication Token IssueSpec.subject_token property.

The property is required when the value of the Vcenter Authentication Token IssueSpec.grant_type property is urn:ietf:params:oauth:grant-type:token-exchange.

This property was added in vSphere API 7.0.2.0.

This property is currently required. In the future, the schema may support grant-types other than urn:ietf:params:oauth:grant-type:token-exchange for which the value may be missing or null.

string
actor_token
Optional

A security token that represents the identity of the acting party. Typically, this will be the party that is authorized to use the requested security token and act on behalf of the subject.

This property was added in vSphere API 7.0.2.0.

missing or null if not needed for the specific case of exchange.

string
actor_token_type
Optional

An identifier, that indicates the type of the security token in the Vcenter Authentication Token IssueSpec.actor_token property.

This property was added in vSphere API 7.0.2.0.

missing or null if Vcenter Authentication Token IssueSpec.actor_token property is not present.