Identity and Access Management SAML API, gRPC: FederationService.Get
Returns the specified federation.
To get the list of available federations, make a List request.
gRPC request
rpc Get (GetFederationRequest) returns (Federation)
GetFederationRequest
{
"federation_id": "string"
}
Field |
Description |
federation_id |
string ID of the federation to return. |
Federation
{
"id": "string",
"folder_id": "string",
"name": "string",
"description": "string",
"created_at": "google.protobuf.Timestamp",
"cookie_max_age": "google.protobuf.Duration",
"auto_create_account_on_login": "bool",
"issuer": "string",
"sso_binding": "BindingType",
"sso_url": "string",
"security_settings": {
"encrypted_assertions": "bool"
},
"case_insensitive_name_ids": "bool"
}
A federation.
For more information, see SAML-compatible identity federations.
Field |
Description |
id |
string Required field. ID of the federation. |
folder_id |
string Required field. ID of the folder that the federation belongs to. |
name |
string Required field. Name of the federation. |
description |
string Description of the federation. |
created_at |
Creation timestamp. |
cookie_max_age |
Browser cookie lifetime in seconds. |
auto_create_account_on_login |
bool Add new users automatically on successful authentication. If the value is |
issuer |
string Required field. ID of the IdP server to be used for authentication. |
sso_binding |
enum BindingType Single sign-on endpoint binding type. Most Identity Providers support the SAML Binding is a mapping of a SAML protocol message onto standard messaging
|
sso_url |
string Required field. Single sign-on endpoint URL. |
security_settings |
Federation security settings. |
case_insensitive_name_ids |
bool Use case insensitive Name IDs. |
FederationSecuritySettings
Federation security settings.
Field |
Description |
encrypted_assertions |
bool Enable encrypted assertions. |