Gerenciar atributos de segurança personalizados para um aplicativo

Realize as etapas a seguir para atribuir atributos de segurança personalizados por meio do centro de administração do Microsoft Entra.

1. Entre no Centro de administração do Microsoft Entra como administrador de atribuição de atributos.

2. Navegue até Entra ID>Aplicativos empresariais.

3. Encontre e selecione o aplicativo ao que você deseja adicionar um atributo de segurança personalizado.

4. Na seção Gerenciar, selecione Atributos de segurança personalizados.

5. Selecione Adicionar atribuição.

6. No conjunto de atributos, selecione um conjunto de atributos na lista.

7. No nome do atributo, selecione um atributo de segurança personalizado na lista.

8. Dependendo das propriedades do atributo de segurança personalizado selecionado, você pode inserir um único valor, selecionar um valor de uma lista predefinida ou adicionar vários valores.

   • Para atributos de segurança personalizados de valor único, insira um valor na caixa Valores Atribuídos .
   • Para valores predefinidos de atributo de segurança personalizado, selecione um valor na lista de valores atribuídos .
   • Para atributos de segurança personalizados de vários valores, selecione Adicionar valores para abrir o painel Valores de Atributo e adicionar seus valores. Quando terminar de adicionar valores, selecione Concluído.

   

9. Quando terminar, selecione Salvar para atribuir os atributos de segurança personalizados ao aplicativo.

Atualizar valores de atribuição de atributo de segurança personalizados para um aplicativo

1. Entre no Centro de administração do Microsoft Entra como administrador de atribuição de atributos.

2. Navegue até Entra ID>Aplicativos empresariais.

3. Localize e selecione o aplicativo que tem um valor de atribuição de atributo de segurança personalizado que você deseja atualizar.

4. Na seção Gerenciar, selecione Atributos de segurança personalizados.

5. Localize o valor de atribuição de atributo de segurança personalizado que você deseja atualizar.

   Depois de atribuir um atributo de segurança personalizado a um aplicativo, você só poderá alterar o valor do atributo de segurança personalizado. Não é possível alterar outras propriedades do atributo de segurança personalizado, como o conjunto de atributos ou o nome do atributo de segurança personalizado.

6. Dependendo das propriedades do atributo de segurança personalizado selecionado, você pode atualizar um único valor, selecionar um valor de uma lista predefinida ou atualizar vários valores.

7. Quando terminar, selecione Salvar.

Filtrar aplicativos com base em atributos de segurança personalizados

Você pode filtrar a lista de atributos de segurança personalizados atribuídos a aplicativos na página Todos os aplicativos .

1. Entre no Centro de administração do Microsoft Entra como, no mínimo, um Administrador de Atribuição de Atributos.

2. Navegue até Entra ID>Aplicativos empresariais.

3. Selecione Adicionar filtros para abrir o painel Escolher um campo.

   Se você não vir Adicionar filtros, selecione o banner para habilitar a prévia de pesquisa de aplicativos empresariais.

4. Para Filtros, selecione Atributo de segurança personalizado.

5. Selecione o conjunto de atributos e o nome do atributo.

6. Para Operador, você pode selecionar iguais (==), não iguais (!=) ou começar com.

7. Para Valor, insira ou selecione um valor.

8. Para aplicar o filtro, selecione Aplicar.

Remover atribuições de atributos de segurança personalizados de aplicativos

1. Entre no Centro de administração do Microsoft Entra como administrador de atribuição de atributo.

2. Navegue até Entra ID>Aplicativos empresariais.

3. Localize e selecione o aplicativo que tem as atribuições de atributos de segurança personalizados que você deseja remover.

4. Na seção Gerenciar , selecione Atributos de segurança personalizados (versão prévia).

5. Adicione marcas de seleção ao lado de todas as atribuições de atributos de segurança personalizados que você deseja remover.

6. Selecione Remover a atribuição.

Microsoft Graph/PowerShell

Você pode usar o PowerShell do Microsoft Graph para gerenciar atribuições de atributos de segurança personalizados para aplicativos em sua organização do Microsoft Entra. Os comandos a seguir podem ser usados para gerenciar atribuições.

Atribuir um atributo de segurança personalizado com um valor de várias cadeias de caracteres a um aplicativo (entidade de serviço) usando o PowerShell do Microsoft Graph

Use o comando Update-MgServicePrincipal para atribuir um atributo de segurança personalizado com um valor de várias cadeias de caracteres a um aplicativo (entidade de serviço).

Considerando os valores

• Conjunto de atributos: Engineering
• Atributo: ProjectDate
• Tipo de dados de atributo: Cadeia de caracteres
• Valor do atributo: "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

Atualizar um atributo de segurança personalizado com um valor de várias cadeias de caracteres para um aplicativo (entidade de serviço) usando o PowerShell do Microsoft Graph

Forneça o novo conjunto de valores de atributo que você gostaria de refletir sobre o aplicativo. Neste exemplo, estamos adicionando mais um valor para o atributo de projeto.

Considerando os valores

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de dados de atributo: coleção de cadeias de caracteres
• Valor do atributo: ["Baker","Cascade"]

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

Filtrar aplicativos com base em atributos de segurança personalizados usando o PowerShell do Microsoft Graph

Este exemplo filtra uma lista de aplicativos com uma atribuição de atributo de segurança personalizada que é igual ao valor especificado.

$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                       : aaaaaaaa-bbbb-cccc-1111-222222222222
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[]]}

Remover atribuições de atributos de segurança personalizados de aplicativos usando o PowerShell do Microsoft Graph

Neste exemplo, removemos uma atribuição de atributo de segurança personalizada que dá suporte a valores únicos.

$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

Neste exemplo, removemos uma atribuição de atributo de segurança personalizada que dá suporte a vários valores.

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

API do Microsoft Graph

Você pode usar a API do Microsoft Graph para gerenciar atribuições de atributos de segurança personalizados para aplicativos em sua organização do Microsoft Entra. Faça as chamadas à API a seguir para gerenciar atribuições.

Para outros exemplos semelhantes da API do Microsoft Graph para usuários, consulte Atribuir, atualizar, listar ou remover atributos de segurança personalizados para um usuário e Exemplos: Atribuir, atualizar, listar ou remover atribuições de atributo de segurança personalizadas usando a API do Microsoft Graph.

Atribuir um atributo de segurança personalizado com um valor de várias cadeias de caracteres a um aplicativo (entidade de serviço) usando a API do Microsoft Graph

Use a API Update servicePrincipal para atribuir um atributo de segurança personalizado com um valor de cadeia de caracteres a um aplicativo.

Considerando os valores

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de dados de atributo: Cadeia de caracteres
• Valor do atributo: "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"
        }
    }
}

Atualizar um atributo de segurança personalizado com um valor de várias cadeias de caracteres para um aplicativo (entidade de serviço) usando a API do Microsoft Graph

Forneça o novo conjunto de valores de atributo que você gostaria de refletir sobre o aplicativo. Neste exemplo, estamos adicionando mais um valor para o atributo de projeto.

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"]
        }
    }
}

Filtrar aplicativos com base em atributos de segurança personalizados usando a API do Microsoft Graph

Este exemplo filtra uma lista de aplicativos com uma atribuição de atributo de segurança personalizada que é igual ao valor especificado. O valor do filtro diferencia maiúsculas de minúsculas. Você precisa adicionar ConsistencyLevel=eventual à solicitação ou ao cabeçalho. Você também deve incluir $count=true para garantir que a solicitação seja roteada corretamente.

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

Remover atribuições de atributos de segurança personalizados de aplicativos usando a API do Microsoft Graph

Neste exemplo, removemos uma atribuição de atributo de segurança personalizada que dá suporte a vários valores.

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

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