Entidades de serviço no Entra ID: melhores práticas e problemas comuns
By Mirko Peters ·
O que é uma entidade de serviço, em que ela difere de um registro de aplicativo, e as práticas de segurança documentadas pela Microsoft: identidades gerenciadas, certificados, privilégio mínimo, proprietários e armadilhas conhecidas.
Automatically translated with AI from the original post. Read the English original
Uma entidade de serviço é a identidade que um aplicativo usa dentro de um locatário do Microsoft Entra. Ela define a que o app pode acessar ali. As práticas de segurança documentadas pela Microsoft são objetivas: prefira identidades gerenciadas, evite segredos, conceda privilégio mínimo, limite os proprietários e revise tudo isso periodicamente.
Pontos-chave
- O objeto de aplicativo é o modelo global no locatário principal. A entidade de serviço é a instância local em cada locatário, que define o que o app pode fazer ali.
- A Microsoft ordena as credenciais da mais para a menos preferida: identidade gerenciada, credenciais federadas, certificados. Ela afirma que você não deve usar segredos (senhas).
- Solicite apenas a permissão menos permissiva, prefira acesso delegado a acesso somente de aplicativo e remova as permissões que o app não precisa mais.
- Mantenha um conjunto mínimo de proprietários, revise a lista de proprietários a cada poucos meses e tenha pelo menos dois proprietários por entidade de serviço.
- Aplicativos e entidades de serviço excluídos podem ser restaurados por até 30 dias. Usuários não administradores podem criar no máximo 250 objetos de aplicativo e entidade de serviço, incluindo os excluídos.
Este artigo segue as páginas do Microsoft Learn sobre objetos de aplicativo e entidade de serviço, segurança de registro de aplicativo e exclusão e recuperação de aplicativos. Quando essas páginas divergem ou não tratam de um ponto, isso é indicado.
Objeto de aplicativo versus entidade de serviço
A Microsoft descreve dois objetos:
- Objeto de aplicativo. A representação global do app. Ele fica no locatário onde o app foi registrado, chamado locatário principal. Funciona como um modelo para as entidades de serviço criadas a partir dele.
- Entidade de serviço. A representação local do app em um locatário. É o principal de segurança que define a política de acesso e as permissões do app nesse locatário.
Um aplicativo de locatário único tem uma entidade de serviço, no locatário principal. Um aplicativo multilocatário tem uma no locatário principal e mais uma em cada locatário onde alguém deu consentimento. Registrar um app no portal cria os dois objetos. Se você registrar pelo Microsoft Graph, a criação da entidade de serviço é uma etapa separada.
Alterações no objeto de aplicativo refletem na entidade de serviço somente no locatário principal. Elas não se propagam para as entidades de serviço em outros locatários.
Os três tipos de entidade de serviço
| Tipo | Objeto de aplicativo vinculado | Você pode editá-lo? | |---|---|---| | Aplicativo | Sim | Regido pelo objeto de aplicativo, com configurações específicas do locatário | | Identidade gerenciada | Não | Pode receber acesso, mas não pode ser modificada diretamente | | Legado | Não | Tem propriedades editáveis, como credenciais e URLs de resposta |
Entidades de serviço legadas são usadas apenas no locatário em que foram criadas. No Microsoft Graph, o tipo aparece na propriedade servicePrincipalType, cuja referência lista mais valores do que esses três, incluindo ServiceIdentity (uma identidade de agente) e SocialIdp (para uso interno). A documentação do Microsoft Graph informa que uma entidade de serviço do tipo Aplicativo cujo registro de aplicativo está ausente não recebe tokens emitidos.
Crie uma da forma documentada
- Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Aplicativos de Nuvem.
- Acesse Entra ID > Registros de aplicativos e selecione Novo registro.
- Informe um nome e escolha Somente contas neste diretório organizacional se o aplicativo for de locatário único.
- Selecione Registrar. A entidade de serviço é criada automaticamente.
Para gerenciar depois as permissões, o consentimento e as informações de entrada, use Aplicativos empresariais. Para acesso ao Azure, a mesma página descreve a atribuição de uma função no escopo de assinatura, grupo de recursos ou recurso, com permissões herdadas pelos escopos inferiores. Escolher o escopo mais restrito que funcione é uma prática geral de privilégio mínimo, não um requisito informado ali.
Melhores práticas da Microsoft
Escolha o tipo de identidade certo
Considere uma identidade gerenciada em vez de um registro de aplicativo quando o serviço for executado no Azure, não autenticar usuários, não for uma API web e não precisar de vários locatários.
Classifique suas credenciais
A Microsoft lista as opções da mais para a menos preferida. A página não chama isso de classificação formal:
- Uma identidade gerenciada como credencial. A Microsoft considera essa opção altamente recomendada, pois não exige gerenciamento de credenciais.
- Credenciais federadas de uma plataforma confiável. A Microsoft recomenda cautela e orienta a configurar credenciais federadas apenas de plataformas em que você confia.
- Um certificado. Armazene-o em um cofre de chaves, como o Azure Key Vault, e prefira um emitido por uma autoridade de certificação confiável.
- Um segredo. A página diz: "Não use credenciais de senha."
Regras relacionadas da mesma página: use políticas de gerenciamento de aplicativos para limitar a vida útil dos segredos ou bloqueá-los, não coloque credenciais em clientes públicos ou instalados, renove as credenciais com frequência, nunca compartilhe credenciais entre aplicativos e evite muitas credenciais em um mesmo aplicativo. A página também recomenda um verificador de credenciais nos pipelines de build, para que as credenciais não acabem em repositórios. A página não informa um intervalo fixo de rotação.
Mantenha os URIs de redirecionamento sob controle
Seja o proprietário de cada URI de redirecionamento, acompanhe os registros DNS por trás deles, evite curingas e esquemas inseguros, como http, e mantenha a lista enxuta. A página diz que uma falha de posse de um URI pode levar ao comprometimento do aplicativo.
Limite as permissões
Solicite apenas a permissão menos permissiva, revise as permissões periodicamente e remova as que o aplicativo não precisa mais. Prefira acesso delegado a acesso somente de aplicativo sempre que possível.
Bloqueie a instância e limite os proprietários
Um administrador do locatário pode personalizar a entidade de serviço em qualquer locatário, o que pode introduzir alterações inesperadas, como credenciais que o proprietário do aplicativo deveria controlar. A Microsoft recomenda configurar o bloqueio de propriedade de instância do aplicativo e bloquear todas as propriedades sensíveis disponíveis. Isso é especialmente crítico para aplicativos multilocatário.
Mantenha a propriedade do aplicativo restrita a um conjunto mínimo de pessoas. Um administrador deve revisar a lista de proprietários uma vez a cada poucos meses. As revisões de acesso do Microsoft Entra podem automatizar essa tarefa. A referência do Microsoft Graph acrescenta a recomendação de pelo menos dois proprietários por entidade de serviço.
Use corretamente os URIs de identificador
Para aplicativos que recebem tokens v1.0, use apenas os URIs padrão, api://<appId> e api://<tenantId>/<appId>. Para tokens v2.0, api://<appId> é o formato recomendado. O valor deve ser único no locatário e não pode terminar com barra. Aplicativos de recurso com URIs de identificador personalizados devem usar o formato de token de acesso v2.0.
Problemas comuns e o que a documentação diz
Os logins são difíceis de rastrear. O Entra tem logs de login separados para service principals e identidades gerenciadas, além dos logins de usuários. Abra o Microsoft Entra admin center como, no mínimo, Reports Reader e vá em Entra ID > Monitoring & health > Sign-in logs. A página que eu li não informa qual aba mostra os logins de service principals.
Um aplicativo deixa de obter tokens. Verifique se o registro do aplicativo ainda existe. Verifique também as propriedades accountEnabled e appRoleAssignmentRequired na entidade de serviço. Se accountEnabled estiver como false, nenhum usuário consegue entrar, mesmo que esteja atribuído. Se appRoleAssignmentRequired estiver como true, é preciso primeiro fazer uma atribuição de função de aplicativo.
Erro de cota na criação. Um usuário não administrador pode criar no máximo 250 aplicativos e entidades de serviço no total. Tanto os objetos ativos quanto os objetos excluídos que ainda podem ser restaurados entram nessa contagem, e a cota só é liberada quando você exclui permanentemente os itens do contêiner de itens excluídos.
A restauração não trouxe tudo de volta. A documentação do Learn traz duas informações. A página sobre objetos de aplicativo diz que restaurar um objeto de aplicativo na interface de Registros de aplicativo não restaura a entidade de serviço correspondente. A FAQ sobre exclusão e recuperação diz que, se ambos tiverem sido excluídos, restaurar o registro também restaura a entidade de serviço. Confira o resultado após qualquer restauração. A FAQ também informa que as políticas de entidade de serviço não podem ser recuperadas e precisam ser configuradas novamente, e que os dados de provisionamento podem levar de 40 minutos a 1 dia para reaparecer.
Você precisa pausar um aplicativo, não excluí-lo. O Learn descreve a desativação de um aplicativo. Ela interrompe a emissão de novos tokens e mantém os objetos para investigação ou para reativação posterior.
Uma rotina curta de revisão
- Liste os aplicativos com segredos e migre-os para certificados ou identidades gerenciadas.
- Remova as permissões que ninguém usa.
- Verifique os proprietários e as datas de expiração.
- Confira se os domínios dos URIs de redirecionamento continuam sob seu controle.
- Revise os logs de entrada das entidades de serviço para identificar aplicativos sem uso.
Relacionados
Fontes
- Microsoft Learn: Práticas recomendadas de segurança para propriedades de aplicativos no Microsoft Entra ID
- Microsoft Learn: Objetos de aplicativo e entidades de serviço no Microsoft Entra ID
- Microsoft Learn: Registrar um aplicativo do Microsoft Entra e criar uma entidade de serviço
- Microsoft Learn: Excluir e recuperar aplicativos e entidades de serviço
- Microsoft Learn: Tipo de recurso servicePrincipal (Microsoft Graph)
- Microsoft Learn: Logs de entrada no Microsoft Entra ID
Perguntas frequentes
Qual é a diferença entre um registro de aplicativo e uma entidade de serviço?
De acordo com o Microsoft Learn, o objeto de aplicativo (o registro de aplicativo) é a representação global de um app e fica no seu locatário principal. A entidade de serviço é a representação local em um locatário específico e define a política de acesso e as permissões ali. Registrar um app no portal cria os dois no locatário principal.
Devo usar um segredo de cliente ou um certificado para uma entidade de serviço?
As orientações de segurança da Microsoft recomendam fortemente uma identidade gerenciada, depois credenciais federadas, mas apenas de plataformas em que você confia, e então credenciais de certificado se nenhuma das anteriores for possível. Ela afirma que você não deve usar credenciais de senha, também chamadas de segredos.
Quando devo usar uma identidade gerenciada em vez de uma entidade de serviço?
O Microsoft Learn lista quatro condições: o serviço é executado no Azure, não autentica usuários, não atua como um recurso de API web e não precisa ser executado em vários locatários. Se as quatro forem verdadeiras, considere uma identidade gerenciada. Uma identidade gerenciada é, por si só, um tipo de entidade de serviço que você não pode editar diretamente.
Posso recuperar uma entidade de serviço excluída?
Segundo as perguntas frequentes sobre exclusão e recuperação do Microsoft Learn, aplicativos e entidades de serviço excluídos temporariamente podem ser restaurados por até 30 dias; depois disso, são excluídos permanentemente. Registros de aplicativo são restaurados no centro de administração do Microsoft Entra. Entidades de serviço são restauradas com PowerShell ou Microsoft Graph, porque entidades de serviço excluídas não aparecem no centro de administração.
Por que recebo o erro Directory_QuotaExceeded ao criar aplicativos?
As perguntas frequentes do Learn informam que um usuário não administrador pode criar no máximo 250 aplicativos e entidades de serviço, e que tanto objetos ativos quanto objetos excluídos que ainda podem ser restaurados contam para essa cota. Excluir objetos, por si só, não libera cota. Você precisa excluí-los permanentemente do contêiner de itens excluídos.