phoneAuthenticationMethod: enableSmsSignIn
Espacio de nombres: microsoft.graph
Habilite el inicio de sesión por SMS para un número de teléfono existente mobile
registrado en un usuario. Para habilitarse correctamente:
- El teléfono debe tener
"phoneType": "mobile"
. - El teléfono debe ser único en el sistema de inicio de sesión de SMS (nadie más puede usar ese número).
- El usuario debe estar habilitado para el inicio de sesión por SMS en la directiva de métodos de autenticación .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Permisos que actúan por sí mismo
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | UserAuthenticationMethod.ReadWrite |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | No admitida. |
Permisos que actúan en otros usuarios
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | UserAuthenticationMethod.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | UserAuthenticationMethod.ReadWrite.All |
Importante
En escenarios delegados con cuentas profesionales o educativas en las que el usuario que ha iniciado sesión actúa sobre otro usuario, se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación.
- Administrador de autenticación
- Administrador de autenticación con privilegios
Solicitud HTTP
Habilite el inicio de sesión por SMS para su propio método de autenticación de teléfono móvil.
POST /me/authentication/phoneMethods/{mobilePhoneMethodId}/enableSmsSignIn
Habilite el inicio de sesión por SMS para su propio método de autenticación de teléfono móvil o para otro usuario.
POST /users/{id | userPrincipalName}/authentication/phoneMethods/{mobilePhoneMethodId}/enableSmsSignIn
El valor de mobilePhoneMethodId
para phoneType mobile
es 3179e48a-750b-4051-897c-87b9720928f7
.
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content
. No devuelve nada en el cuerpo de la respuesta.
Ejemplos
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7/enableSmsSignIn
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content