Edit

Share via


qrPin resource type

Namespace: microsoft.graph

Represents the PIN credential associated with a qrCodePinAuthenticationMethod. The PIN is a memorized secret that users enter after successful QR code verification.

The PIN must be between 8-20 digits, with a minimum default length of 8 digits as per NIST standards. When a PIN is created by an admin or reset, it's a temporary PIN that requires the user to change it on their next sign-in. The PIN code value is only returned at the time of creation or reset.

Inherits from entity.

Methods

Method Return type Description
Reset PIN qrPin Reset a user's PIN to a new temporary PIN that must be changed on next sign-in.
Update PIN qrPin Update a user's PIN.

Properties

Property Type Description
code String The PIN code value. This property is only returned at the time of creating or resetting the PIN. For GET operations, this property returns null. The PIN must be between 8-20 digits.
createdDateTime DateTimeOffset The date and time when the PIN was created. Read-only.
forceChangePinNextSignIn Boolean Indicates whether the user must change the PIN on their next sign-in. This is true when an admin creates or resets the PIN, and false after the user changes it.
id String The unique identifier for the PIN. Inherited from entity. Read-only.
updatedDateTime DateTimeOffset The date and time when the PIN was last updated. Read-only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.qrPin",
  "id": "String (identifier)",
  "code": "String",
  "createdDateTime": "String (timestamp)",
  "forceChangePinNextSignIn": "Boolean",
  "updatedDateTime": "String (timestamp)"
}