current_principal_details()
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 } |