Attributs du langage d'expression pour les appareils

Lorsque vous utilisez Okta Expression Language pour créer une expression personnalisée pour les appareils, vous pouvez faire référence aux attributs suivants, présents dans le profil d'appareil de Okta :

Nom et type d'attribut

Description

Plateforme

Exemples

device.assurance.screenLockType

Type : Chaîne

Obtient la valeur du type de verrouillage d'écran de l'appareil.

 Toutes les plateformes

NONE: aucun code d'accès n'est configuré sur l'appareil.

PASSCODE: l'appareil n'a qu'un code d'accès ou un mot de passe configuré. Les données biométriques ne sont pas configurées.

BIOMETRIC: le code d'accès et la biométrie sont configurés sur l'appareil. (Non disponible sur Linux).

device.caller.binaryIdentifier

Type : Chaîne

Identifie l'app que vous avez autorisé à invoquer Okta FastPass.

 macOS, Windows

Exemples : Google Chrome ou 3AQ936H96.org.mozilla.firefox

Les identificateurs binaires exacts des applications se trouvent dans votre System Log.

device.caller.bindingType

Type : Chaîne

Récupère la méthode de liaison utilisée pour l'authentification.

 macOS, Windows, Linux

LOOPBACK : utilise une liaison en boucle.

APPLE_SSO_EXTENSION : utilise l'extension SSO Apple pour la liaison. (macOS uniquement)

device.caller.validationStatus

Type : Chaîne

Indique si le binaire est signé.

 macOS, Windows

Renvoie SUCCESS si le binaire est signé.

device.id

Type : Chaîne

Obtient l'identificateur unique qu'Okta affecte à l'appareil.

 Toutes les plateformes

Renvoie l'identifiant attribué par Okta à l'appareil lorsque l'utilisateur s'authentifie avec Okta FastPass sur un appareil inscrit à Okta FastPass.

Cet attribut ne renvoie aucune valeur lorsque l'utilisateur s'authentifie à l'aide d'un mot de passe ou de tout autre authentificateur, ou lorsque l'appareil n'est pas enrôlé dans Okta FastPass.

device.provider.oktaVerify.version

Type : Chaîne

Obtient la valeur de la version de l'appareil Okta Verify.

Utilisez les fonctions versionGreaterThan et versionLessThan pour comparer avec les niveaux de version de Okta Verify.

Utilisez == pour effectuer une comparaison avec une version exacte Okta Verify .

 Toutes les plateformes

device.provider.oktaVerify.version.versionGreaterThan('9.43') == true

device.provider.oktaVerify.version.versionLessThan('9.42.0') == true

device.provider.oktaVerify.version == '9.46.1.2025.710.1826'

device.profile.diskEncryptionType

Type : Chaîne

Obtient la valeur du type de chiffrement de disque du profil de l'appareil.

Toutes les plateformes

NONE: aucun chiffrement n'a été configuré. (Toutes les plateformes)

FULL: Le disque est entièrement chiffré. (Android, iOS)

USER : La clé de chiffrement est liée à l'utilisateur ou au profil (Android).

ALL_INTERNAL_VOLUMES : tous les disques internes sont chiffrés. (macOS, Windows, Linux)

SYSTEM_VOLUME : seul le volume système est chiffré. (macOS, Windows, Linux)

device.profile.displayName

Type : Chaîne

Obtient la valeur de l'attribut de nom d'affichage du profil de l'appareil.

Les caractères UTF-8 à 4 octets ne sont pas pris en charge.

Toutes les plateformes

DESKTOP-BE6IL05, XYZ S21

device.profile.integrityDebug

Type : Booléen

Indique si un débogueur a été détecté.

Android, iOS

true ou false

device.profile.integrityEmulator

Type : Booléen

Indique si l'appareil fonctionne comme un émulateur.

Android, iOS

true ou false

device.profile.integrityHook

Type : Booléen

Indique si des fonctions internes ou des appels d'exécution ont été détectés.

 Android, iOS

true ou false

device.profile.integrityJailbreak

Type : Booléen

Indique si l'appareil mobile a été jailbreaké ou rooté.

Android, iOS

true ou false

device.profile.integrityRepackage

Type : Booléen

Indique si l'appli de l'appareil mobile a été reconditionnée par un tiers inconnu.

 Android, iOS

true ou false

device.profile.managed

Type : Booléen

Obtient la valeur de l'attribut géré du profil de l'appareil.

Toutes les plateformes

true ou false

device.profile.manufacturer

Type : Chaîne

Obtient la valeur de l'attribut constructeur du profil de l'appareil.

Toutes les plateformes

VMware, Inc.

Samsung

device.profile.model

Type : Chaîne

Obtient la valeur de l'attribut de modèle du profil de l'appareil.

Toutes les plateformes

VMware7,1

SM-G991U1

device.profile.osVersion

Type : Chaîne

Obtient la valeur de l'attribut de version du système d'exploitation du profil de l'appareil.

Utilisez les fonctions versionGreaterThan ou versionLessThan pour comparer les versions du OS.

Toutes les plateformes

10.0.18362

30

device.profile.osVersion.versionGreaterThan('14.2.1') == true

device.profile.platform

Type : Chaîne

Obtient la valeur du système d'exploitation du profil de l'appareil.

 Toutes les plateformes, y compris ChromeOS

IOS, ANDROID, LINUX, WINDOWS, MACOS, MOBILE_OTHER, DESKTOP_OTHER, ou CHROMEOS

device.profile.registered

Type : Booléen

Obtient la valeur de l'attribut enregistré du profil de l'appareil.

Toutes les plateformes

true

device.profile.secureHardwarePresent

Type : Booléen

Obtient la valeur de l'attribut actuel Matériel sécurisé du profil de l'appareil.

Cette vérification porte sur la présence d'une puce, sous la forme d'un module TPM (Trusted Platform Module) ou d'une Secure Enclave. Il ne vérifie pas la présence de jetons sur le matériel sécurisé.

Toutes les plateformes

true ou false

device.profile.serialNumber

Type : Chaîne

Obtient la valeur de l'attribut de numéro de série du profil de l'appareil.

Sur Linux, cet attribut renvoie null.

Toutes les plateformes (via MDM), sauf Linux

VMware-56 5d e2 35 bd d8 66 75-5a bc 10 06 4c 6a fb 85

device.profile.sid

Type : Chaîne

Récupère la valeur de l'attribut d'identifiant de sécurité (SID) du profil de l'appareil. Ceci n'est disponible qu'avec les appareils Windows.

Windows

S-1-5-21-1016203815-1917570059-4244971090-500

device.profile.tpmPublicKeyHash

Type : Chaîne

Obtient la valeur de l'attribut de hachage de la clé publique du Trusted Platform Module (TPM) du profil de l'appareil.

 Windows

18e3b568aeb17b4e75f3838d6b01ffe63c52d976950943a10968761b5bfe3f4d

device.profile.udid

Type : Chaîne

Obtient la valeur de l'attribut UDID (Unique Device ID) du profil de l'appareil.

Sur Android, iOS, et macOS, cet attribut n'est disponible qu'avec certains scénarios gérés.

Sur Linux, cet attribut est toujours présent car la valeur est récupérée depuis /etc/machine-id.

 Android, iOS, macOS, Linux

35E24D56-D8BD-7566-1ABC-10064C6AFB85

Attributs d'accès des appareils

Le tableau suivant répertorie les attributs d'accès des appareils.

Nom et type d'attribut

Description

Plateforme

Exemples

device.provider.deviceAccess.joined

Type : Booléen

Indique si l'appareil est joint à Okta pour l'utilisation de fonctionnalités avancées comme Device-Bound SSO.

Consultez Device-Bound Single Sign-On pour plus d'informations.

macOS, Windows

true ou false

device.provider.deviceAccess.joined == true

Opérateurs

Utilisez des opérateurs dans votre expression personnalisée pour gérer les décisions. Tout opérateur Okta Expression Language peut être utilisé dans une expression personnalisée. Le tableau suivant liste les opérateurs couramment utilisés :

Opérateur Description
&& Signifie une fonction AND.
|| Signifie une fonction OR.
! Signifie une fonction NOT.
<, >, <= et >= Signifie les opérateurs relationnels.
== Vérifie l'égalité.
!= Vérifie l'inégalité.

Consultez Okta Expression Language pour une liste complète des fonctions d'Okta Expression Language.

Considérations importantes

  • Incluez toujours device.profile.registered == true si vous souhaitez inclure des conditions relatives à l'appareil dans votre expression personnalisée.
  • En général, les attributs d'appareil ne peuvent être utilisés que si Okta FastPass est activé.
  • Les attributs de l'appareil ne peuvent être évalués que si Okta Verify est installé.