Entidade de serviço do Azure

Visão geral

As credenciais da entidade de serviço do Azure autenticam as solicitações do AutoSSL aos serviços do Azure pelo Microsoft Entra ID. Ao adicionar uma entidade de serviço, você autoriza o AutoSSL a agir em seu nome, por exemplo para enviar arquivos de certificado SSL ao Azure Blob Storage.

Parâmetros de configuração

Parâmetro	Descrição
Tenant ID	O ID do locatário do Microsoft Entra ID (Azure AD).
Client ID	O ID do aplicativo (cliente) da entidade de serviço.
Client Secret	O segredo do cliente da entidade de serviço. Esse valor é criptografado antes de ser armazenado no AutoSSL.

Importante

Se você precisar alterar o campo Client Secret depois, informe o segredo completo de novo.

Como criar uma entidade de serviço

Entre no portal do Azure.
Vá em Microsoft Entra ID > App registrations > New registration.
Informe um nome (por exemplo, AutoSSL) e clique em Register.
Copie o Application (client) ID e o Directory (tenant) ID na página de visão geral.
Vá em Certificates & secrets > New client secret, crie um segredo e copie o valor na hora.
Cole o Tenant ID, o Client ID e o Client Secret no AutoSSL.

Para mais detalhes, consulte a documentação do Azure sobre criação de uma entidade de serviço.

Recomendações de segurança

Privilégio mínimo: conceda à entidade de serviço apenas os papéis RBAC necessários para os recursos de destino (por exemplo, Storage Blob Data Contributor em uma conta de armazenamento ou contêiner específico).
Rotação periódica: troque os segredos do cliente de tempos em tempos e atualize-os no AutoSSL.
Entidade de serviço dedicada: crie uma entidade de serviço só para o AutoSSL, em vez de reutilizar credenciais de outros aplicativos.

Alvos de implantação com suporte

A entidade de serviço do Azure é usada por estes provedores de implantação no AutoSSL:

Azure Blob Storage: envia arquivos de certificado para um contêiner de blobs, com caminhos versionados e latest.