Partilhar via

Usar certificados TLS/SSL em seu aplicativo no Azure Spring Apps

  • Artigo

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a:✅ Basic/Standard ✅ Enterprise

Este artigo mostra como usar certificados públicos no Azure Spring Apps para seu aplicativo. Seu aplicativo pode atuar como um cliente e acessar um serviço externo que requer autenticação de certificado ou pode precisar executar tarefas criptográficas.

Ao permitir que o Azure Spring Apps gerencie seus certificados TLS/SSL, você pode manter os certificados e o código do aplicativo separadamente para proteger seus dados confidenciais. O código do seu aplicativo pode acessar os certificados públicos que você adiciona à sua instância do Azure Spring Apps.

Pré-requisitos

Importar um certificado

Você pode optar por importar seu certificado para sua instância do Azure Spring Apps do Cofre da Chave ou usar um arquivo de certificado local.

Importar um certificado do Cofre da Chave

Você precisa conceder acesso ao Azure Spring Apps ao seu cofre de chaves antes de importar seu certificado.

O Azure Key Vault oferece dois sistemas de autorização: o controle de acesso baseado em função do Azure (Azure RBAC), que opera nos planos de controle e dados do Azure, e o modelo de política de acesso, que opera apenas no plano de dados.

Use as seguintes etapas para conceder acesso:

  1. Inicie sessão no portal do Azure.

  2. Selecione Cofres de chaves e, em seguida, selecione o cofre de chaves do qual você importa seu certificado.

  3. No painel de navegação, selecione Políticas de acesso e, em seguida, selecione Criar.

  4. Selecione Permissões de certificado e, em seguida, selecione Obter e Listar.

    Captura de ecrã do portal do Azure que mostra a página Criar uma política de acesso com o painel Permissão a mostrar e as permissões Obter e Listar realçadas.

  5. Em Principal, selecione Azure Spring Cloud Resource Provider.

    Captura de ecrã do portal do Azure que mostra o separador Principal Criar uma página de política de acesso com o Azure Spring Cloud Resource Provider realçado.

  6. Selecione Rever + Criar e, em seguida, selecione Criar.

Depois de conceder acesso ao cofre de chaves, você pode importar seu certificado usando as seguintes etapas:

  1. Vá para sua instância de serviço.

  2. No painel de navegação esquerdo da sua instância, selecione Configurações TLS/SSL.

  3. Selecione Importar Certificado do Cofre da Chave na seção Certificados de Chave Pública .

  4. Selecione seu cofre de chaves na seção Cofres de chaves, selecione seu certificado na seção Certificado e selecione Selecionar.

  5. Forneça um valor para Nome do certificado, selecione Ativar sincronização automática, se necessário, e selecione Aplicar. Para obter mais informações, consulte a seção Certificado de sincronização automática de Mapear um domínio personalizado existente para o Azure Spring Apps.

Depois de importar com êxito o certificado, você o verá na lista de Certificados de Chave Pública.

Nota

As instâncias do Azure Key Vault e do Azure Spring Apps devem estar no mesmo locatário.

Importar um arquivo de certificado local

Você pode importar um arquivo de certificado armazenado localmente usando estas etapas:

  1. Vá para sua instância de serviço.
  2. No painel de navegação esquerdo da sua instância, selecione Configurações TLS/SSL.
  3. Selecione Carregar certificado público na seção Certificados de chave pública.

Depois de importar com êxito o certificado, você o verá na lista de Certificados de Chave Pública.

Carregar um certificado

Para carregar um certificado em seu aplicativo no Azure Spring Apps, comece com estas etapas:

  1. Vá para a instância do aplicativo.
  2. No painel de navegação esquerdo do seu aplicativo, selecione Gerenciamento de certificados.
  3. Selecione Adicionar certificado para escolher certificados acessíveis para o aplicativo.

Captura de ecrã do portal do Azure que mostra a página Gestão de certificados com o botão Adicionar certificado realçado.

Carregar um certificado a partir do código

Seus certificados carregados estão disponíveis na pasta /etc/azure-spring-cloud/certs/public . Use o seguinte código Java para carregar um certificado público em um aplicativo no Azure Spring Apps.

CertificateFactory factory = CertificateFactory.getInstance("X509");
FileInputStream is = new FileInputStream("/etc/azure-spring-cloud/certs/public/<certificate name>");
X509Certificate cert = (X509Certificate) factory.generateCertificate(is);

// use the loaded certificate

Carregar um certificado no armazenamento confiável

Para um aplicativo Java, você pode escolher Carregar no armazenamento confiável para o certificado selecionado. O certificado é adicionado automaticamente às TrustStores padrão Java para autenticar um servidor na autenticação TLS/SSL.

O log a seguir do seu aplicativo mostra que o certificado foi carregado com êxito.

Load certificate from specific path. alias = <certificate alias>, thumbprint = <certificate thumbprint>, file = <certificate name>

Próximos passos