current_principal_details()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Retorna detalhes da entidade de segurança que está executando a consulta.

Sintaxe

current_principal_details()

Saiba mais sobre as convenções de sintaxe.

Devoluções

Os detalhes da entidade de segurança atual como uma dinâmica. A tabela a seguir descreve os campos retornados.

Campo Descrição
UserPrincipalName O identificador de entrada para usuários. Para obter mais informações, consulte UPN.
IdentityProvider A fonte que valida a identidade da entidade de segurança.
Autoridade A ID de locatário do Microsoft Entra.
MFA Indica o uso da autenticação multifator. Para obter mais informações, consulte Referência de declarações de token de acesso.
Tipo A categoria da entidade principal: aaduser, aadapp, ou aadgroup.
DisplayName O nome amigável da entidade de segurança exibida na interface do usuário.
ObjectId A ID do objeto do Microsoft Entra para a entidade de segurança.
FQN O FQN (Nome Totalmente Qualificado) da entidade de segurança. Valioso para comandos de gerenciamento de função de segurança. Para obter mais informações, consulte Referenciando entidades de segurança.
País/região O país ou região do usuário. Essa propriedade será retornada se as informações estiverem presentes. O valor é um código padrão de país ou região de duas letras, por exemplo, FR, JP e SZ.
País do inquilino O país ou a região do locatário do recurso, definido em um nível de locatário por um administrador. Essa propriedade será retornada se as informações estiverem presentes. O valor é um código padrão de país ou região de duas letras, por exemplo, FR, JP e SZ.
Região do locatário A região do locatário do recurso. Essa propriedade será retornada se as informações estiverem presentes. O valor é um código padrão de país ou região de duas letras, por exemplo, FR, JP e SZ.

Exemplo

print details=current_principal_details()

Saída de exemplo

detalhes
{
"UserPrincipalName": "user@fabrikam.com",
"IdentityProvider": "https://sts.windows.net",
"Autoridade": "72f988bf-86f1-41af-91ab-2d7cd011db47",
"Mfa": "Verdadeiro",
"Tipo": "AadUser",
"DisplayName": "James Smith (upn: user@fabrikam.com)",
"ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"FQN": nulo,
"Notas": null
}