Gérer des attributs de sécurité personnalisés pour une application

Article
12/28/2023

Les attributs de sécurité personnalisés dans Microsoft Entra ID sont des attributs spécifiques à l'entreprise (paires clé-valeur) que vous pouvez définir et attribuer aux objets Microsoft Entra. Par exemple, vous pouvez affecter un attribut de sécurité personnalisé pour filtrer vos applications ou pour vous aider à déterminer qui y a accès. Cet article explique comment attribuer, mettre à jour, répertorier ou supprimer des attributs de sécurité personnalisés pour les applications d'entreprise Microsoft Entra.

Prérequis

Pour attribuer ou supprimer des attributs de sécurité personnalisés pour une application dans votre client Microsoft Entra, vous avez besoin de :

Administrateur d’affection d’attribut
Vérifiez que vous disposez d’attributs de sécurité personnalisés existants. Pour savoir comment créer un attribut de sécurité, consultez Ajouter ou désactiver des attributs de sécurité personnalisés dans Microsoft Entra ID.

Important

Par défaut, le rôle Administrateur général et d’autres rôles d’administrateur ne sont pas autorisés à lire, définir ou attribuer des attributs de sécurité personnalisés.

Affecter, mettre à jour, répertorier ou supprimer des attributs de sécurité personnalisés pour une application

Découvrez comment utiliser des attributs personnalisés pour les applications dans Microsoft Entra ID.

Affecter des attributs de sécurité personnalisés à une application

Conseil

Les étapes décrites dans cet article peuvent varier légèrement en fonction du portail de départ.

Effectuez les étapes suivantes pour affecter des attributs de sécurité personnalisés via le centre d’administration Microsoft Entra.

Connectez-vous au centre d’administration Microsoft Entra en tant qu’Administrateur d’affectation d’attributs.
Accédez à Identité>Applications>Applications d’entreprise.
Recherchez et sélectionnez l’application à laquelle vous souhaitez ajouter un attribut de sécurité personnalisé.
Dans la section Gérer, sélectionnez Attributs de sécurité personnalisés.
Sélectionnez Ajouter une attribution.
Sous Jeu d’attributs, sélectionnez un jeu d’attributs dans la liste.
Sous Nom d’attribut, sélectionnez un attribut de sécurité personnalisé dans la liste.
Selon les propriétés de l’attribut de sécurité personnalisé sélectionné, vous pouvez entrer une valeur unique, sélectionner une valeur dans une liste prédéfinie ou ajouter plusieurs valeurs.
- Pour les attributs de sécurité personnalisés à valeur unique en forme libre, entrez une valeur dans la zone Valeurs attribuées.
- Pour les valeurs d’attribut de sécurité personnalisés prédéfinies, sélectionnez une valeur dans la liste Valeurs attribuées .
- Pour les attributs de sécurité personnalisés à valeurs multiples, sélectionnez Ajouter des valeurs pour ouvrir le volet Valeurs d’attribut et ajouter vos valeurs. Lorsque vous avez fini d’ajouter des valeurs, sélectionnez Terminé.
Lorsque vous avez terminé, sélectionnez Enregistrer pour affecter les attributs de sécurité personnalisés à l’application.

Mettre à jour les valeurs d’affectation d’attribut de sécurité personnalisé pour une application

Connectez-vous au centre d’administration Microsoft Entra en tant qu’Administrateur d’affectation d’attributs.
Accédez à Identité>Applications>Applications d’entreprise.
Recherchez et sélectionnez l’application qui a une valeur d’affectation d’attribut de sécurité personnalisé que vous souhaitez mettre à jour.
Dans la section Gérer, sélectionnez Attributs de sécurité personnalisés.
Recherchez la valeur d’affectation d’attribut de sécurité personnalisé que vous souhaitez mettre à jour.

Une fois un attribut de sécurité personnalisé affecté à une application, vous pouvez uniquement modifier la valeur de l’attribut. Vous ne pouvez pas modifier d’autres propriétés de l’attribut de sécurité personnalisé, telles que le jeu d’attributs ou le nom d’attribut.
Selon les propriétés de l’attribut de sécurité personnalisé sélectionné, vous pouvez mettre à jour une valeur unique, sélectionner une valeur dans une liste prédéfinie ou mettre à jour plusieurs valeurs.
Lorsque vous avez terminé, sélectionnez Enregistrer.

Filtrer les applications en fonction des attributs de sécurité personnalisés

Vous pouvez filtrer la liste des attributs de sécurité personnalisés affectés à des applications dans la page Toutes les applications.

Connectez-vous au centre d’administration Microsoft Entra avec au moins le rôle Administrateur d’affectation d’attributs.
Accédez à Identité>Applications>Applications d’entreprise.
Sélectionnez Ajouter des filtres pour ouvrir le volet Choisir un champ.

Si vous ne voyez pas l’option Ajouter des filtres, sélectionnez la bannière pour activer la préversion de recherche concernant Applications d’entreprise.
Pour Filtres, sélectionnez Attribut de sécurité personnalisé.
Sélectionnez le jeu d’attributs et le nom d’attribut.
Pour Opérateur, vous pouvez sélectionner est égal à (==), différent de (!=) ou Commence par.
Pour Valeur, entrez ou sélectionnez une valeur.
Pour appliquer le filtre, sélectionnez Appliquer.

Supprimer des affectations d’attribut de sécurité personnalisé d’applications

Connectez-vous au centre d'administration Microsoft Entra en tant qu'Administrateur d’affectation d’attributs.
Accédez à Identité>Applications>Applications d’entreprise.
Recherchez et sélectionnez l’application qui a les affectations d’attribut de sécurité personnalisé que vous souhaitez supprimer.
Dans la section Gérer, sélectionnez Attributs de sécurité personnalisés (préversion).
Ajoutez des coches en regard de toutes les affectations d’attribut de sécurité personnalisé que vous souhaitez supprimer.
Sélectionnez Supprimer l’attribution.

Azure AD PowerShell

Pour gérer les attributions d'attributs de sécurité personnalisés pour les applications de votre organisation Microsoft Entra, vous pouvez utiliser PowerShell. Vous pouvez utiliser les commandes suivantes pour gérer les affectations.

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide d’Azure AD PowerShell

Utilisez la commande Set-AzureADMSServicePrincipal pour affecter un attribut de sécurité personnalisé avec une valeur multichaîne à une application (principal de service).

Ensemble d’attributs : Engineering
Attribut : Project
Type de données d’attribut : Collection de chaînes
Valeur d’attribut : ("Baker","Cascade")

$attributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Baker","Cascade")
    }
}
Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributes

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide d’Azure AD PowerShell

Fournissez le nouveau jeu de valeurs d’attribut que vous souhaitez refléter sur l’application. Dans cet exemple, nous ajoutons une valeur supplémentaire pour l’attribut du projet.

Ensemble d’attributs : Engineering
Attribut : Project
Type de données d’attribut : Collection de chaînes
Valeur d’attribut : ("Alpine","Baker")

$attributesUpdate = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Alpine","Baker")
    }
}
Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributesUpdate

Obtenez les affectations d’attribut de sécurité personnalisé pour une application (principal de service) à l’aide d’Azure AD PowerShell

Utilisez la commande Get-AzureADMSServicePrincipal pour obtenir les affectations d’attribut de sécurité personnalisé pour une application (principal de service).

Get-AzureADMSServicePrincipal -Select CustomSecurityAttributes
Get-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20  -Select "CustomSecurityAttributes, Id"

Microsoft Graph PowerShell

Pour gérer les attributions d'attributs de sécurité personnalisés pour les applications de votre organisation Microsoft Entra, vous pouvez utiliser Microsoft Graph PowerShell. Vous pouvez utiliser les commandes suivantes pour gérer les affectations.

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide de Microsoft Graph PowerShell

Utilisez la commande Update-MgServicePrincipal pour affecter un attribut de sécurité personnalisé avec une valeur multi-chaîne à une application (principal de service).

Compte tenu des valeurs

Ensemble d’attributs : Engineering
Attribut : ProjectDate
Type de données d’attribut : chaîne
Valeur d’attribut : "2024-11-15"

#Retrieve the servicePrincipal

$ServicePrincipal = (Get-MgServicePrincipal -Filter "displayName eq 'TestApp'").Id

$customSecurityAttributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "ProjectDate" ="2024-11-15"
    }
}
Update-MgServicePrincipal -ServicePrincipalId $ServicePrincipal -CustomSecurityAttributes $customSecurityAttributes

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide de Microsoft Graph PowerShell

Fournissez le nouveau jeu de valeurs d’attribut que vous souhaitez refléter sur l’application. Dans cet exemple, nous ajoutons une valeur supplémentaire pour l’attribut du projet.

Compte tenu des valeurs

Ensemble d’attributs : Engineering
Attribut : Project
Type de données d’attribut : Collection de chaînes
Valeur d’attribut : ["Baker","Cascade"]

$customSecurityAttributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        "Project" = @(
            "Baker"
            "Cascade"
        )
    }
}
Update-MgServicePrincipal -ServicePrincipalId $ServicePrincipal -CustomSecurityAttributes $customSecurityAttributes

Filtrez les applications en fonction des attributs de sécurité personnalisés à l’aide de Microsoft Graph PowerShell

Cet exemple filtre une liste d’applications ayant une attribution d’attribut de sécurité personnalisé égale à la valeur spécifiée.

$appAttributes = Get-MgServicePrincipal -CountVariable CountVar -Property "id,displayName,customSecurityAttributes" -Filter "customSecurityAttributes/Engineering/Project eq 'Baker'" -ConsistencyLevel eventual
$appAttributes | select Id,DisplayName,CustomSecurityAttributes  | Format-List
$appAttributes.CustomSecurityAttributes.AdditionalProperties | Format-List

Id                       : 7d194b0c-bf17-40ff-9f7f-4b671de8dc20
DisplayName              : TestApp
CustomSecurityAttributes : Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue

Key   : Engineering
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [ProjectDate, 2024-11-15], [Project@odata.type, #Collection(String)], [Project, System.Object[]]}

Supprimez des affectations d’attribut de sécurité personnalisé à partir d’applications à l’aide de Microsoft Graph PowerShell

Dans cet exemple, nous supprimons une attribution d’attribut de sécurité personnalisée qui prend en charge des valeurs uniques.


$params = @{
    "customSecurityAttributes" = @{
        "Engineering" = @{
            "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
            "ProjectDate" = $null
        }
    }
}
Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/servicePrincipals/$ServicePrincipal" -Body $params

Dans cet exemple, nous supprimons une attribution d’attribut de sécurité personnalisé prenant en charge plusieurs valeurs.

$customSecurityAttributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project" = @()
    }
}
Update-MgServicePrincipal -ServicePrincipalId $ServicePrincipal -CustomSecurityAttributes $customSecurityAttributes

API Microsoft Graph

Pour gérer les attributions d'attributs de sécurité personnalisés pour les applications de votre organisation Microsoft Entra, vous pouvez utiliser l'API Microsoft Graph. Effectuez les appels d’API suivants pour gérer les attributs.

Pour obtenir d’autres exemples similaires d’API Microsoft Graph pour les utilisateurs, veuillez consulter les rubriques Attribuer, mettre à jour, répertorier ou supprimer des attributs de sécurité personnalisés pour un utilisateur et Exemples : attribuer, mettre à jour, répertorier ou supprimer des attributs de sécurité personnalisés à l’aide de l’API Microsoft Graph.

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide de de l'API Microsoft Graph

Utilisez l’API Mettre à jour servicePrincipal afin d’attribuer à une application un attribut de sécurité personnalisé avec une valeur chaîne.

Compte tenu des valeurs

Ensemble d’attributs : Engineering
Attribut : Project
Type de données d’attribut : chaîne
Valeur d’attribut : "Baker"

PATCH https://graph.microsoft.com/v1.0/servicePrincipals/{id}
Content-type: application/json

{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project@odata.type":"#Collection(String)",
            "Project": "Baker"
        }
    }
}

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide de l’API Microsoft Graph

Fournissez le nouveau jeu de valeurs d’attribut que vous souhaitez refléter sur l’application. Dans cet exemple, nous ajoutons une valeur supplémentaire pour l’attribut du projet.

PATCH https://graph.microsoft.com/v1.0/servicePrincipals/{id}
Content-type: application/json

{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project@odata.type":"#Collection(String)",
            "Project":["Baker","Cascade"]
        }
    }
}

Filtrez les applications en fonction des attributs de sécurité personnalisés à l’aide de l’API Microsoft Graph

Cet exemple filtre une liste d’applications ayant une attribution d’attribut de sécurité personnalisé égale à la valeur spécifiée. La valeur de filtre est sensible à la casse. Vous devez ajouter ConsistencyLevel=eventual dans la requête ou l’en-tête. Vous devez également inclure $count=true pour vous assurer que la demande est acheminée correctement.

GET https://graph.microsoft.com/v1.0/servicePrincipals?$count=true&$select=id,displayName,customSecurityAttributes&$filter=customSecurityAttributes/Engineering/Project eq 'Baker'
ConsistencyLevel: eventual

Supprimez des attribut de sécurité personnalisé à partir d’une application à l’aide de l’API Microsoft Graph

Dans cet exemple, nous supprimons une attribution d’attribut de sécurité personnalisé prenant en charge plusieurs valeurs.

PATCH https://graph.microsoft.com/v1.0/servicePrincipals/{id}
Content-type: application/json

{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project":[]
        }
    }
}

Gérer des attributs de sécurité personnalisés pour une application

Prérequis

Affecter, mettre à jour, répertorier ou supprimer des attributs de sécurité personnalisés pour une application

Affecter des attributs de sécurité personnalisés à une application

Mettre à jour les valeurs d’affectation d’attribut de sécurité personnalisé pour une application

Filtrer les applications en fonction des attributs de sécurité personnalisés

Supprimer des affectations d’attribut de sécurité personnalisé d’applications

Azure AD PowerShell

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide d’Azure AD PowerShell

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide d’Azure AD PowerShell

Obtenez les affectations d’attribut de sécurité personnalisé pour une application (principal de service) à l’aide d’Azure AD PowerShell

Microsoft Graph PowerShell

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide de Microsoft Graph PowerShell

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide de Microsoft Graph PowerShell

Filtrez les applications en fonction des attributs de sécurité personnalisés à l’aide de Microsoft Graph PowerShell

Supprimez des affectations d’attribut de sécurité personnalisé à partir d’applications à l’aide de Microsoft Graph PowerShell

API Microsoft Graph

Attribuez un attribut de sécurité personnalisé avec une valeur à chaînes multiples à une application (principal de service) à l’aide de de l'API Microsoft Graph

Mettez à jour un attribut de sécurité personnalisé avec une valeur à chaînes multiples pour une application (principal de service) à l’aide de l’API Microsoft Graph

Filtrez les applications en fonction des attributs de sécurité personnalisés à l’aide de l’API Microsoft Graph

Supprimez des attribut de sécurité personnalisé à partir d’une application à l’aide de l’API Microsoft Graph

Étapes suivantes

Ressources supplémentaires