UserAuthenticationMethod.ReadWrite.All

Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the UserAuthenticationMethod.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	50483e42-d915-4231-9639-7fdb7fd190e5	b7887744-6746-4312-813d-72daeaee7e2d
DisplayText	Read and write all users' authentication methods	Read and write all users' authentication methods.
Description	Allows the application to read and write authentication methods of all users in your organization, without a signed-in user. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods	Allows the app to read and write authentication methods of all users in your organization that the signed-in user has access to. Authentication methods include things like a user’s phone numbers and Authenticator app settings. This does not allow the app to see secret information like passwords, or to sign-in or otherwise use the authentication methods.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /me/authentication/emailMethods/{emailMethods-id}
	DELETE /me/authentication/fido2Methods/{id}
	DELETE /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
	DELETE /me/authentication/phoneMethods/{phoneMethodId}
	DELETE /me/authentication/softwareOathMethods/{id}
	DELETE /me/authentication/temporaryAccessPassMethods/{id}
	DELETE /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
	GET /me/authentication/emailMethods
	GET /me/authentication/emailMethods/{emailMethods-id}
	GET /me/authentication/fido2Methods
	GET /me/authentication/fido2Methods/{id}
	GET /me/authentication/methods
	GET /me/authentication/methods/{id}
	GET /me/authentication/microsoftAuthenticatorMethods
	GET /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
	GET /me/authentication/passwordMethods
	GET /me/authentication/passwordMethods/{passwordMethods-id}
	GET /me/authentication/phoneMethods
	GET /me/authentication/phoneMethods/{phoneMethodId}
	GET /me/authentication/softwareOathMethods
	GET /me/authentication/softwareOathMethods/{id}
	GET /me/authentication/temporaryAccessPassMethods
	GET /me/authentication/temporaryAccessPassMethods/{temporaryAccessPassAuthenticationMethodId}
	GET /me/authentication/windowsHelloForBusinessMethods
	GET /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
	GET /users/{id \| userPrincipalName}/authentication/operations/{id}
	PATCH /users/{id \| userPrincipalName}/authentication/emailMethods/{emailMethods-id}
	PATCH /users/{id \| userPrincipalName}/authentication/phoneMethods/{phoneMethodId}
	POST /me/authentication/phoneMethods/{mobilePhoneMethodId}/disableSmsSignIn
	POST /me/authentication/phoneMethods/{mobilePhoneMethodId}/enableSmsSignIn
	POST /users/{id \| userPrincipalName}/authentication/emailMethods
	POST /users/{id \| userPrincipalName}/authentication/methods/{passwordMethods-id}/resetPassword
	POST /users/{id \| userPrincipalName}/authentication/phoneMethods
	POST /users/{id \| userPrincipalName}/authentication/temporaryAccessPassMethods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /me/authentication/emailMethods/{emailMethods-id}
	DELETE /me/authentication/fido2Methods/{id}
	DELETE /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
	DELETE /me/authentication/passwordlessMicrosoftAuthenticatorMethods/{id}
	DELETE /me/authentication/phoneMethods/{phoneMethodId}
	DELETE /me/authentication/platformCredentialMethods/{platformCredentialAuthenticationMethodId}
	DELETE /me/authentication/softwareOathMethods/{id}
	DELETE /me/authentication/temporaryAccessPassMethods/{id}
	DELETE /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
	GET /identityGovernance/roleManagementAlerts/operations/{longRunningOperationId}
	GET /me/authentication/emailMethods
	GET /me/authentication/emailMethods/{emailMethods-id}
	GET /me/authentication/fido2Methods
	GET /me/authentication/fido2Methods/{id}
	GET /me/authentication/methods
	GET /me/authentication/methods/{id}
	GET /me/authentication/microsoftAuthenticatorMethods
	GET /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
	GET /me/authentication/passwordlessMicrosoftAuthenticatorMethods
	GET /me/authentication/passwordlessMicrosoftAuthenticatorMethods/{id}
	GET /me/authentication/passwordMethods
	GET /me/authentication/passwordMethods/{passwordMethods-id}
	GET /me/authentication/phoneMethods
	GET /me/authentication/phoneMethods/{phoneMethodId}
	GET /me/authentication/platformCredentialMethods
	GET /me/authentication/platformCredentialMethods/{platformCredentialAuthenticationMethodId}
	GET /me/authentication/softwareOathMethods
	GET /me/authentication/softwareOathMethods/{id}
	GET /me/authentication/temporaryAccessPassMethods
	GET /me/authentication/temporaryAccessPassMethods/{temporaryAccessPassAuthenticationMethodId}
	GET /me/authentication/windowsHelloForBusinessMethods
	GET /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
	GET /users/{id \| userPrincipalName}/authentication/methods/{id}
	GET /users/{user-id}/authentication/fido2Methods/creationOptions(challengeTimeoutInMinutes={challengeTimeoutInMinutes})
	PATCH /users/{id \| userPrincipalName}/authentication/emailMethods/{emailMethods-id}
	PATCH /users/{id \| userPrincipalName}/authentication/phoneMethods/{phoneMethodId}
	PATCH /users/{id \| userPrincipalName}/authentication/signInPreferences
	POST /me/authentication/phoneMethods/{id}/disableSmsSignIn
	POST /me/authentication/phoneMethods/{id}/enableSmsSignIn
	POST /users/{id \| userPrincipalName}/authentication/emailMethods
	POST /users/{id \| userPrincipalName}/authentication/methods/{passwordMethods-id}/resetPassword
	POST /users/{id \| userPrincipalName}/authentication/phoneMethods
	POST /users/{id \| userPrincipalName}/authentication/phoneMethods/{id}/disableSmsSignIn
	POST /users/{id \| userPrincipalName}/authentication/phoneMethods/{id}/enableSmsSignIn
	POST /users/{id \| userPrincipalName}/authentication/temporaryAccessPassMethods
	POST /users/{id}/authentication/fido2methods

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Disable-MgUserAuthenticationPhoneMethodSmsSignIn
	Enable-MgUserAuthenticationPhoneMethodSmsSignIn
	Get-MgUserAuthenticationEmailMethod
	Get-MgUserAuthenticationFido2Method
	Get-MgUserAuthenticationMethod
	Get-MgUserAuthenticationMicrosoftAuthenticatorMethod
	Get-MgUserAuthenticationOperation
	Get-MgUserAuthenticationPasswordMethod
	Get-MgUserAuthenticationPhoneMethod
	Get-MgUserAuthenticationSoftwareOathMethod
	Get-MgUserAuthenticationTemporaryAccessPassMethod
	Get-MgUserAuthenticationWindowsHelloForBusinessMethod
	New-MgUserAuthenticationEmailMethod
	New-MgUserAuthenticationPhoneMethod
	New-MgUserAuthenticationTemporaryAccessPassMethod
	Remove-MgUserAuthenticationEmailMethod
	Remove-MgUserAuthenticationFido2Method
	Remove-MgUserAuthenticationMicrosoftAuthenticatorMethod
	Remove-MgUserAuthenticationPhoneMethod
	Remove-MgUserAuthenticationSoftwareOathMethod
	Remove-MgUserAuthenticationTemporaryAccessPassMethod
	Remove-MgUserAuthenticationWindowsHelloForBusinessMethod
	Reset-MgUserAuthenticationMethodPassword
	Update-MgUserAuthenticationEmailMethod
	Update-MgUserAuthenticationPhoneMethod

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaUserAuthenticationEmailMethod
	Get-MgBetaUserAuthenticationFido2Method
	Get-MgBetaUserAuthenticationMethod
	Get-MgBetaUserAuthenticationMicrosoftAuthenticatorMethod
	Get-MgBetaUserAuthenticationOperation
	Get-MgBetaUserAuthenticationPasswordlessMicrosoftAuthenticatorMethod
	Get-MgBetaUserAuthenticationPasswordMethod
	Get-MgBetaUserAuthenticationPhoneMethod
	Get-MgBetaUserAuthenticationPlatformCredentialMethod
	Get-MgBetaUserAuthenticationSoftwareOathMethod
	Get-MgBetaUserAuthenticationTemporaryAccessPassMethod
	Get-MgBetaUserAuthenticationWindowsHelloForBusinessMethod
	Invoke-MgBetaCreationUserAuthenticationFido2MethodOption
	New-MgBetaUserAuthenticationEmailMethod
	New-MgBetaUserAuthenticationPhoneMethod
	New-MgBetaUserAuthenticationTemporaryAccessPassMethod
	Remove-MgBetaUserAuthenticationEmailMethod
	Remove-MgBetaUserAuthenticationFido2Method
	Remove-MgBetaUserAuthenticationMicrosoftAuthenticatorMethod
	Remove-MgBetaUserAuthenticationPasswordlessMicrosoftAuthenticatorMethod
	Remove-MgBetaUserAuthenticationPhoneMethod
	Remove-MgBetaUserAuthenticationPlatformCredentialMethod
	Remove-MgBetaUserAuthenticationSoftwareOathMethod
	Remove-MgBetaUserAuthenticationTemporaryAccessPassMethod
	Remove-MgBetaUserAuthenticationWindowsHelloForBusinessMethod
	Reset-MgBetaUserAuthenticationMethodPassword
	Update-MgBetaUserAuthenticationEmailMethod
	Update-MgBetaUserAuthenticationPhoneMethod
	Update-MgBetaUserAuthenticationSignInPreference

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: authenticationMethod

Property	Type	Description
id	String	The identifier of this instance of an authentication method registered to this user. Read-only.

Graph reference: emailAuthenticationMethod

Property	Type	Description
emailAddress	String	The email address registered to this user.
id	String	The identifier of the email address registered to this user. The ID is always `3ddfcfc8-9383-446f-83cc-3ab9be4be18f`.

Graph reference: fido2AuthenticationMethod

Property	Type	Description
aaGuid	String	Authenticator Attestation GUID, an identifier that indicates the type (e.g. make and model) of the authenticator.
attestationCertificates	String collection	The attestation certificate(s) attached to this security key.
attestationLevel	attestationLevel	The attestation level of this FIDO2 security key. Possible values are: `attested`, or `notAttested`.
createdDateTime	DateTimeOffset	The timestamp when this key was registered to the user.
displayName	String	The display name of the key as given by the user.
id	String	The authentication method identifier.
model	String	The manufacturer-assigned model of the FIDO2 security key.

Graph reference: longRunningOperation

Property	Type	Description
createdDateTime	DateTimeOffset	The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
id	String	The unique identifier of the operation.
lastActionDateTime	DateTimeOffset	The time of the last action in the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
resourceLocation	String	URI of the resource that the operation is performed on.
status	longRunningOperationStatus	The status of the operation. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`.
statusDetail	String	Details about the status of the operation.

Graph reference: microsoftAuthenticatorAuthenticationMethod

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time that this app was registered. This property is null if the device isn't registered for passwordless Phone Sign-In.
deviceTag	String	Tags containing app metadata.
displayName	String	The name of the device on which this app is registered.
id	String	A unique identifier for this authentication method. Inherited from authenticationMethod
phoneAppVersion	String	Numerical version of this instance of the Authenticator app.

Graph reference: passwordAuthenticationMethod

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time when this password was last updated. This property is currently not populated. Read-only. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
id	String	The identifier of this password registered to this user. This is generally `28c10230-6103-485e-b985-444c60001490`. Read-only.
password	String	For security, the password is always returned as `null` from a LIST or GET operation.

Graph reference: passwordlessmicrosoftauthenticatorauthenticationmethod

Property	Type	Description
id	String	The authentication method identifier.
displayName	String	The display name of the mobile device as given by the user.
creationDateTime	DateTimeOffset	The timestamp when this method was registered to the user.

Property	Type	Description
newPassword	String	The Microsoft Entra ID-generated password.

Graph reference: phoneAuthenticationMethod

Property	Type	Description
id	String	The identifier of this phone registered to this user. Read-only. The value of ID is one of the following: `b6332ec1-7057-4abe-9331-3d72feddfe41` - where phoneType is `alternateMobile`. `e37fc753-ff3b-4958-9484-eaa9425c82bc` - where phoneType is `office`. `3179e48a-750b-4051-897c-87b9720928f7` - where phoneType is `mobile`.
phoneNumber	String	The phone number to text or call for authentication. Phone numbers use the format `+{country code} {number}x{extension}`, with extension optional. For example, `+1 5555551234` or `+1 5555551234x123` are valid. Numbers are rejected when creating or updating if they don't match the required format.
phoneType	authenticationPhoneType	The type of this phone. Possible values are: `mobile`, `alternateMobile`, or `office`.
smsSignInState	authenticationMethodSignInState	Whether a phone is ready to be used for SMS sign-in or not. Possible values are: `notSupported`, `notAllowedByPolicy`, `notEnabled`, `phoneNumberNotUnique`, `ready`, or `notConfigured`, `unknownFutureValue`.

Graph reference: platformCredentialAuthenticationMethod

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time that this Platform Credential Key was registered.
displayName	String	The name of the device on which Platform Credential is registered.
id	String	A unique identifier for this authentication method. Inherited from authenticationMethod
keyStrength	authenticationMethodKeyStrength	Key strength of this Platform Credential key. Possible values are: `normal`, `weak`, `unknown`.
platform	authenticationMethodPlatform	Platform on which this Platform Credential key is present. Possible values are: `unknown`, `windows`, `macOS`,`iOS`, `android`, `linux`.

Graph reference: softwareOathAuthenticationMethod

Property	Type	Description
id	String	The authentication method identifier.
secretKey	String	The secret key of the method. Always returns `null`.

Graph reference: strongAuthenticationRequirements

Property	Type	Description
perUserMfaState	perUserMfaState	Sets the per-user MFA state for the user. The possible values are: `disabled`, `enforced`, `enabled`, `unknownFutureValue`. When you update a user's MFA state to `enabled` and the user has already registered an MFA method, their state changes automatically to `enforced`.

Graph reference: temporaryAccessPassAuthenticationMethod

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time when the Temporary Access Pass was created.
id	String	The identifier of the Temporary Access Pass registered to this user. Inherited from entity.
isUsable	Boolean	The state of the authentication method that indicates whether it's currently usable by the user.
isUsableOnce	Boolean	Determines whether the pass is limited to a one-time use. If `true`, the pass can be used once; if `false`, the pass can be used multiple times within the Temporary Access Pass lifetime.
lifetimeInMinutes	Int32	The lifetime of the Temporary Access Pass in minutes starting at startDateTime. Must be between 10 and 43200 inclusive (equivalent to 30 days).
methodUsabilityReason	String	Details about the usability state (isUsable). Reasons can include: `EnabledByPolicy`, `DisabledByPolicy`, `Expired`, `NotYetValid`, `OneTimeUsed`.
startDateTime	DateTimeOffset	The date and time when the Temporary Access Pass becomes available to use and when isUsable is `true` is enforced.
temporaryAccessPass	String	The Temporary Access Pass used to authenticate. Returned only on creation of a new **t

Graph reference: temporaryAccessPassAuthenticationMethodConfiguration

Property	Type	Description
defaultLength	Int	Default length in characters of a Temporary Access Pass object. Must be between 8 and 48 characters.
defaultLifetimeInMinutes	Int	Default lifetime in minutes for a Temporary Access Pass. Value can be any integer between the minimumLifetimeInMinutes and maximumLifetimeInMinutes.
excludeTargets	excludeTarget collection	Groups of users that are excluded from the policy.
id	String	The identifier of the authentication method policy. Inherited from entity.
isUsableOnce	Boolean	If `true`, all the passes in the tenant will be restricted to one-time use. If `false`, passes in the tenant can be created to be either one-time use or reusable.
maximumLifetimeInMinutes	Int	Maximum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).
minimumLifetimeInMinutes	Int	Minimum lifetime in minutes for any Temporary Access Pass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).
state	authenticationMethodState	Whether the Temporary Access Pass method is enabled in the tenant. Possible values are: `enabled`, `disabled`. Inherited from authenticationMethodConfiguration.

Graph reference: webauthnCredentialCreationOptions

Property	Type	Description
challengeTimeoutDateTime	DateTimeOffset	Defines when the challenge in the creation options is no longer valid. Expired challenges are rejected when you attempt to create a new fido2AuthenticationMethod.
publicKey	webauthnCredentialCreationOptions	Defines public key options for the creation of a new WebAuthn public key credential.

Graph reference: webauthnPublicKeyCredential

Property	Type	Description
id	String	The credential ID created by the WebAuthn Authenticator.
response	webauthnAuthenticatorAttestationResponse	Response data returned from a WebAuthn authenticator after it creates a new public key credential.
clientExtensionResults	webauthnAuthenticationExtensionsClientOutputs	The untyped results from the execution of extensions requested by the client when creating a new public key credential.

Graph reference: windowsHelloForBusinessAuthenticationMethod

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time that this Windows Hello for Business key was registered.
displayName	String	The name of the device on which Windows Hello for Business is registered
id	String	A unique identifier for this authentication method. Inherited from authenticationMethod
keyStrength	authenticationMethodKeyStrength	Key strength of this Windows Hello for Business key. Possible values are: `normal`, `weak`, `unknown`.

Table of Contents

UserAuthenticationMethod.ReadWrite.All

Graph Methods

Resources