Docs Home

/ /

Autenticación federada

Docs Home

/ /

Recursos

Autenticación federada

Autenticación federada

Retornar Todas las Organizaciones Conectadas

El recurso federationSettings te permite devolver todas las organizaciones conectadas para una configuración de autenticación federada.

URL base: https://cloud.mongodb.com/api/public/v1.0

Roles necesarios

Debe tener el rol Organization Owner para al menos una organización conectada en la configuración de la federación para poder llamar a este endpoint.

Resource

GET /federationSettings/{FEDERATION-SETTINGS-ID}/connectedOrgConfigs/

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
`FEDERATION-SETTINGS-ID`	string	string única de 24 dígitos hexadecimales que identifica la configuración de autenticación federada.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
Num. de pág.	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
elementosPorPágina	Número	Opcional	Número de elementos a devolver por página, hasta un máximo de 500.	`100`
bonito	booleano	Opcional	Indicador que señala si el cuerpo de la respuesta debe estar en formato prettyprint.	`false`
envelope	booleano	Opcional	Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP o al código de estado. Para remediarlo, establezca `envelope : true` en la query. Para los endpoints que devuelven una lista de resultados, el objeto `content` es un sobre. Cloud Manager añade el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir los demonios que no están habilitados para hacer copias de seguridad de bases de datos de la respuesta. Establece esto en `false` para incluir las configuraciones del demonio con la bandera `backupJobsEnabled` establecida en `false`.	`true`

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

Respuesta

Documento de respuesta

El documento de respuesta JSON incluye un arreglo de objetos result, un arreglo de objetos link y el recuento del número total de objetos result recuperados.

Nombre	Tipo	Descripción
Resultados	Arreglo de objetos	Un objeto para cada elemento detallado en la sección documento incrustado de resultados.
enlaces	Arreglo de objetos	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
totalCount	entero	Conteo del número total de elementos en el conjunto de resultados. Puede ser superior al número de objetos en el arreglo de resultados si todo el conjunto de resultados está paginado.

resultados Documento incrustado

Cada documento en el arreglo result contiene la configuración de autenticación federada para cada organización conectada.

Nombre	Tipo	Descripción
`domainAllowList`	arreglo	Lista que contiene los dominios aprobados desde los cuales los usuarios de la organización pueden iniciar sesión.
`domainRestrictionEnabled`	booleano	Indicador que señala si la restricción de dominio está habilitada para la organización conectada. `userConflicts` devuelve `null` cuando `"domainRestrictionEnabled": false`.
`identityProviderId`	string	string única de 20 dígitos hexadecimales que identifica al proveedor de identidad asociado con la organización conectada.
`orgId`	string	string única de 24 dígitos hexadecimales que identifica a la organización conectada.
`postAuthRoleGrants`	arreglo	Lista que contiene los roles por defecto concedidos a los usuarios que se autentican a través del proveedor de identidad en una organización conectada.
`roleMappings`	arreglo	Lista que contiene las asignaciones de roles configuradas en esta organización.
`userConflicts`	arreglo	Lista que contiene los nombres de usuario que no coinciden con ningún dominio de la lista permitida. `userConflicts` devuelve `null` cuando `"domainRestrictionEnabled": false`.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/federationSettings/{FEDERATION-SETTINGS-ID}/connectedOrgConfigs"

Respuesta de ejemplo

{
 "links": [
     {
         "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/federationSettings/{FEDERATION-SETTINGS-ID}/connectedOrgConfigs?pageNum=1&itemsPerPage=100",
         "rel": "self"
     }
 ],
 "results": [
     {
         "domainAllowList": [],
         "domainRestrictionEnabled": false,
         "identityProviderId": null,
         "orgId": "5f86fb11e0079069c9ec3132",
         "postAuthRoleGrants": [],
         "roleMappings": [],
         "userConflicts": null
     }
 ],
 "totalCount": 1
}

Volver

Configuración de devolución

Return Organización