Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Lea las propiedades y relaciones de un objeto signInIdentifierBase .
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | SignInIdentifier.Read.All | SignInIdentifier.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | SignInIdentifier.Read.All | SignInIdentifier.ReadWrite.All |
Importante
Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. El administrador de directivas de autenticación es el rol con privilegios mínimos admitido para esta operación.
Solicitud HTTP
GET /identity/signInIdentifiers/{signInIdentifier-name}
Parámetros de ruta de acceso
| Parameter | Tipo | Descripción |
|---|---|---|
| signInIdentifier-name | Cadena | Nombre del identificador de inicio de sesión que se va a recuperar. Valores admitidos: Email, UPN, Username, CustomUsername1, CustomUsername2. |
Parámetros de consulta opcionales
Este método no admite parámetros de consulta OData para ayudar a personalizar la respuesta. El identificador de inicio de sesión se recupera directamente a través de la ruta de acceso de la dirección URL.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se realiza correctamente, este método devuelve un 200 OK código de respuesta y un objeto signInIdentifierBase en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Obtener el identificador de inicio de sesión de Email
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/identity/signInIdentifiers/Email
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.emailSignInIdentifier",
"name": "Email",
"isEnabled": true
}
Ejemplo 2: Obtener identificador de inicio de sesión de nombre de usuario personalizado
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/identity/signInIdentifiers/CustomUsername1
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.customUsernameSignInIdentifier",
"name": "CustomUsername1",
"isEnabled": true,
"validationRegex": "^[a-zA-Z]{4}\\d{5}$"
}