Girando segredos manualmente

Alternando segredos arbitrários

É possível usar a IU do Secrets Manager para girar manualmente seus segredos arbitrários.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.
5. Selecione um novo arquivo ou insira um novo valor de segredo.
6. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.
   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.
7. Para alternar o segredo imediatamente, clique em Alternar.
8. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criando novas versões de segredos de valor de chave

É possível usar a IU do Secrets Manager para girar manualmente seus segredos de chave-valor.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.
5. Selecione um arquivo ou insira um novo valor de segredo no formato JSON.
6. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.
   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.
7. Para alternar o segredo imediatamente, clique em Alternar.
8. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criando novas versões de credenciais do usuário

É possível usar a IU do Secrets Manager para girar manualmente os valores de senha que estão associados a um segredo de credenciais do usuário.

1. No console, clique no ícone Menu > Lista de Recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na IU Secrets Manager, acesse a lista Segredos.

4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.

5. Determine se deve-se inserir sua própria senha ou gerar uma nova.

   Se você optar por gerar uma nova senha, o Secrets Manager substituirá o valor existente por uma senha de 32 caracteres gerada aleatoriamente que contém letras maiúsculas, letras minúsculas, dígitos e símbolos.

6. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.

   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.

7. Para alternar o segredo imediatamente, clique em Alternar.

8. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criação de novas versões de credenciais do IAM

Você pode usar a interface do usuário Secrets Manager para alternar manualmente os valores de senha associados a um segredo de credenciais do IAM.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.
5. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.
   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.
6. Para alternar o segredo imediatamente, clique em Alternar.
7. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criando novas versões de credenciais de serviço

Você pode usar a interface do usuário Secrets Manager para girar manualmente os valores de senha associados a um segredo de credenciais de serviço.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.
5. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.
   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.
6. Para alternar o segredo imediatamente, clique em Alternar.
7. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criação de novas versões de credenciais personalizadas

Você pode usar a interface do usuário Secrets Manager para girar manualmente os valores de senha associados a um segredo de credenciais personalizadas.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha para o segredo que deseja alternar, clique no menu Ações > Alternar.
5. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.
   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.
6. Para alternar o segredo imediatamente, clique em Alternar.
7. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

Criando novas versões de certificados importados

Quando chegar a hora de renovar um certificado que foi inicialmente importado para o serviço, você poderá usar a interface do usuário Secrets Manager para importá-lo manualmente. Depois que um certificado é alternado, a versão anterior é mantida, caso você precise dela.

Se o certificado que você está rodando foi previamente importado com um certificado intermediário e uma chave privada, inclua um certificado intermediário e chave privada na rotação para evitar interrupções de serviço.

1. No console, clique no ícone Menu > Lista de Recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na IU Secrets Manager, acesse a lista Segredos.

4. Na linha do certificado que deseja alternar, clique no menu Ações > Alternar.

5. Selecione ou insira os novos dados do certificado.

   Lembre-se de que a rotação manual de um certificado substitui o conteúdo do certificado pelos novos dados que você fornece apenas. As chaves privadas e os certificados intermediários das versões anteriores não são retidos.

6. Para alternar o certificado imediatamente, clique em Alternar.

7. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.

8. Reimplemente a versão de certificado mais recente no seu ponto de finalização do TLS.

   Para acessar a versão atual, é possível fazer download do certificado ou recuperá-la programaticamente usando a API Get a secret.

Criação de novas versões de certificados importados com CSR gerenciado

Você pode usar a interface do usuário Secrets Manager para criar a primeira versão do certificado ou a próxima versão quando for a hora de renovar o certificado.

1. No console, clique no ícone Menu > Lista de Recursos.
2. Na lista de serviços, selecione sua instância do Secrets Manager.
3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha do certificado que deseja alternar, clique no menu Ações > Alternar.
5. Selecione o arquivo de certificado que foi assinado usando o CSR atual ou insira seus dados.
6. Opcional: Selecione o arquivo CA intermediário de assinatura ou insira seus dados.
7. Para alternar o certificado imediatamente, clique em Alternar.
8. Opcional: verifique o histórico de versões para visualizar as atualizações mais recentes.
9. Reimplemente a versão de certificado mais recente no seu ponto de finalização do TLS.

Para acessar a versão atual, você pode fazer o download do certificado ou recuperá-lo programaticamente usando a API Get a secret.

Criando novas versões de certificados privados

Se a sua instância de serviço do Secrets Manager estiver ativada para certificados privados, será possível renovar manualmente um certificado que foi emitido anteriormente por uma autoridade de certificação configurada para sua instância de serviço.

1. No console, clique no ícone Menu > Lista de Recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na IU Secrets Manager, acesse a lista Segredos.

4. Na linha do certificado que deseja alternar, clique no menu Ações > Alternar.

5. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.

   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.

6. Clique em Girar.

7. Reimplemente a versão de certificado mais recente no seu ponto de finalização do TLS.

   Para acessar a versão atual, é possível fazer download do certificado ou recuperá-la programaticamente usando a API Get a secret.

Criando novas versões de certificados públicos

Se a sua instância de serviço do Secrets Manager estiver ativada para certificados públicos, será possível renovar manualmente um certificado que foi solicitado anteriormente a partir de uma autoridade de certificação de terceiros.

1. No console, clique no ícone Menu > Lista de Recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na IU Secrets Manager, acesse a lista Segredos.

4. Na linha do certificado que deseja alternar, clique no menu Ações > Alternar.

5. Opcional: inclua metadados em seu segredo ou em uma versão específica do seu segredo.

   1. Faça o upload de um arquivo ou insira os metadados e os metadados da versão no formato JSON.

6. Clique em Girar.

   Uma mensagem de sucesso é exibida para indicar que sua solicitação está sendo processada. Se a validação for concluída com sucesso, um novo certificado será emitido e o status do certificado será alterado de Ativo, alternância pendente para Ativo. Se a validação não for concluída com sucesso, o status do certificado mudará para Ativo, Rotação com falha.

7. Opcional: verifique os detalhes da emissão de um certificado.

   É possível conferir os detalhes de emissão de um certificado público, clicando no ícone Ações > Detalhes. Se houve um problema com a solicitação, o campo Status fornecerá informações sobre por que a rotação não foi concluída com sucesso.

8. Reimplemente a versão de certificado mais recente no seu ponto de finalização do TLS.

   Para acessar a versão atual, é possível fazer download do certificado ou recuperá-la programaticamente usando a API Get a secret.

Criando novas versões de certificados públicos com seu próprio provedor DNS na IU

Para girar um certificado público que foi criado usando um provedor de DNS manual na UI, preencha as etapas a seguir.

1. No console, clique no ícone Menu > Lista de Recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na linha do certificado que deseja alternar, clique no menu Ações > Alternar.

4. Opcional: Adicione um nome e uma descrição para identificar facilmente seu certificado.

5. Opcional: Clique em Atualizar.

6. Clique Em Desafios para acessar o nome de registro TXT e valor que estão associados a cada um de seus domínios. Você precisa deles para completar os desafios.

7. Para validar a propriedade de seus domínios, inclua manualmente os registros TXT que são fornecidos para cada um de seus domínios para a sua conta de provedor DNS. Você deve abordar apenas os desafios que não são validados, antes da data de expiração.

   Se você solicitar um certificado para subdomínios, por exemplo, sub1.sub2.domain.com, você precisa adicionar os registros TXT em seu domínio registrado domain.com.

8. Verifique se os registros TXT que você adicionou em seus domínios são propagados. Dependendo do seu provedor de DNS, ele pode levar algum tempo para ser concluído.

9. Após confirmar se os registros são propagados, clique em Validar para solicitar Vamos Encrypt para validar os desafios para os seus domínios e criar um certificado público.

   Se a ordem falhar, por exemplo, se os registros TXT não foram propagados com sucesso, você deve iniciar uma nova ordem para prosseguir.

10. Quando o seu certificado é emitido, limpe e remova os registros TXT dos domínios em sua conta de provedor DNS.

Alternando segredos arbitrários

Para alternar um segredo arbitrário usando o plug-in da CLI do Secrets Manager, execute o comando ibmcloud secrets-manager secret-version-create. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

ibmcloud secrets-manager secret-version-create \    
   --secret-id=SECRET_ID \    
   --secret-version-prototype='{"payload": "updated secret credentials", "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Segredos de credenciais de serviço rotativos

Para rotacionar um segredo de credenciais de serviço usando o plug-in Secrets Manager CLI, execute o comando ibmcloud secrets-manager secret-version-create comando. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Rotação de segredos de credenciais personalizadas

Para rotacionar um segredo de credenciais personalizado usando o plug-in Secrets Manager CLI, execute o comando ibmcloud secrets-manager secret-version-create comando. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Alternando credenciais do usuário

Para alternar um segredo de credencial do usuário usando o plug-in da CLI do Secrets Manager, execute o comando ibmcloud secrets-manager secret-version-create. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-password como sua nova versão.

ibmcloud secrets-manager secret-version-create \    
   --secret-id SECRET_ID \    
   --secret-version-prototype='{"password": "new-password", "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

Para que o serviço gere e designe uma senha aleatória à credencial, omita o campo password. Por exemplo, {}. O Secrets Manager substitui o valor existente por uma senha de 32 caracteres gerada aleatoriamente que contém letras maiúsculas, letras minúsculas, dígitos e símbolos.

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Gerenciando credenciais do IAM

Para girar um segredo de credencial do IAM usando o plug-in da CLI Secrets Manager, execute o comando ibmcloud secrets-manager secret-version-create. Por exemplo, o comando a seguir criará uma nova chave API

ibmcloud secrets-manager secret-version-create \    
   --secret-id SECRET_ID

A rotação manual de credenciais de IAM só é possível se a opção Reutilizar credenciais de IAM estiver definida como Ativada.

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Girando certificados importados

Para rotacionar um certificado usando o plug-in CLI Secrets Manager CLI plug-in, execute o comando ibmcloud secrets-manager secret-version-create comando. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

certificate=$(cat cert.pem)
intermediate=$(cat intermediate.pem)
private_key=$(cat private_key.pem)
ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID --imported-cert-certificate ${certificate} --imported-cert-intermediate ${intermediate} --imported-cert-private-key ${private_key}

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Rotação de certificados importados com CSR gerenciado

Para importar novamente um certificado usando o plug-in Secrets Manager CLI, execute o comando ibmcloud secrets-manager secret-version-create comando. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

Quando o segredo do certificado importado estiver gerenciando uma CSR, o campo private_key não será permitido.

certificate=$(cat cert.pem)
intermediate=$(cat intermediate.pem)
ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID --imported-cert-certificate ${certificate} --imported-cert-intermediate ${intermediate}

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Rotacionando certificados privados

Para criar um novo segredo de certificado privado usando o plug-in Secrets Manager CLI, execute o comando ibmcloud secrets-manager secret-version-create comando.

ibmcloud secrets-manager secret-version-create \
   --secret-id SECRET_ID
   --secret-version-prototype '{"csr":"..."}' # Keep empty JSON if not needed

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Girando certificados públicos

Para pedir um novo segredo de certificado público usando o plug-in da CLI do Secrets Manager, execute o comando ibmcloud secrets-manager secret-version-create

ibmcloud secrets-manager secret-version-create \
   --secret-id SECRET_ID \
   --public-cert-rotation '{"rotate_keys": true|false}'

Ao girar um certificado, escolha se também deve girar sua chave privada para designar true ou false para o campo rotate_keys

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Segredos do KV rotativo

Para girar um segredo do KV usando o plug-in da CLI do Secrets Manager, execute o comando ibmcloud secrets-manager secret-version-create. Por exemplo, o comando a seguir rotaciona um segredo e atribui new-secret-data como sua nova versão.

ibmcloud secrets-manager secret-version-create \    
   --secret-id=SECRET_ID \    
   --secret-version-prototype='{"data": {"key":"value"}, "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

O comando gera o valor do segredo, juntamente com outros metadados. Para obter mais informações sobre as opções de comando, consulte ibmcloud secrets-manager secret-version-create.

Alternando segredos arbitrários

É possível girar segredos arbitrários chamando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "custom_metadata": {
            "metadata_custom_key": "metadata_custom_value"
            },
         "payload": "Updated arbitrary data",
         "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
            }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Girando segredos de chave-valor

É possível girar segredos de chave-valor chamando a API Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer ${iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "data": {
            "key1": "val2"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Alternando credenciais do usuário

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "password": "new-password",
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Para que o serviço gere e designe uma senha aleatória à credencial, omita o campo password. Por exemplo, {}. O Secrets Manager substitui o valor existente por uma senha de 32 caracteres gerada aleatoriamente que contém letras maiúsculas, letras minúsculas, dígitos e símbolos.

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Gerenciando credenciais do IAM

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Credenciais do serviço rotativo

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Credenciais personalizadas rotativas

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Girando certificados importados

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "certificate": "-----BEGIN CERTIFICATE-----\nMIIE3jCCBGSgAwIBAgIUZfTbf3adn87l5J2Q2Aw+6Vk/qhowCgYIKoZIzj0EAwIwx\n-----END CERTIFICATE-----", "custom_metadata": {
            "metadata_custom_key": "metadata_custom_value"
         },
         "intermediate": "-----BEGIN CERTIFICATE-----\nMIIE3DCCBGKgAwIBAgIUKncnp6BdSUKAFGBcP4YVp/gTb7gwCgYIKoZIzj0EAwIw\n-----END CERTIFICATE-----",
         "private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAqcRbzV1wp0nVrPtEpMtnWMO6Js1q3rhREZluKZfu0Q8SY4H3\n-----END RSA PRIVATE KEY-----", "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Substitua novas linhas nos dados de chave de certificado, intermediária e privada por \n

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Rotação de certificados importados com CSR gerenciado

É possível girar segredos usando a API do Secrets Manager.
A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Quando o segredo do certificado importado estiver gerenciando uma CSR, o campo private_key não será permitido.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "certificate": "-----BEGIN CERTIFICATE-----\nMIIE3jCCBGSgAwIBAgIUZfTbf3adn87l5J2Q2Aw+6Vk/qhowCgYIKoZIzj0EAwIwx\n-----END CERTIFICATE-----",
         "intermediate": "-----BEGIN CERTIFICATE-----\nMIIE3DCCBGKgAwIBAgIUKncnp6BdSUKAFGBcP4YVp/gTb7gwCgYIKoZIzj0EAwIw\n-----END CERTIFICATE-----"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Girando certificados públicos

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
        "rotation": {
          "rotate_keys": true # or false
        },
        "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
        }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Substitua novas linhas nos dados de chave de certificado, intermediária e privada por \n

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Rotacionando certificados privados

É possível girar segredos usando a API do Secrets Manager.

A solicitação de exemplo a seguir cria uma nova versão do seu segredo. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

Você pode armazenar metadados que são relevantes para as necessidades de sua organização com os parâmetros de solicitação custom_metadata e version_custom_metadata. Os valores do version_custom_metadata são retornados apenas para as versões de um segredo. Os metadados personalizados do seu segredo são armazenados como todos os outros metadados, para versões de até 50 bits e você não deve incluir dados confidenciais.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
        "csr": '{}' # Keep empty if not required
        "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
        }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Substitua novas linhas nos dados de chave de certificado, intermediária e privada por \n

Uma resposta bem-sucedida retorna o valor do ID do segredo, além de outros metadados. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, confira os Docs da API.

Alternando segredos arbitrários

É possível girar segredos arbitrários usando o Terraform for Secrets Manager.

Para girar um segredo arbitrário, modifique o valor do atributo payload na configuração do recurso ibm_sm_arbitrary_secret e execute terraform apply para aplicar a mudança. Se você estiver usando uma variável de entrada para a carga útil, modifique seu valor no arquivo variables.tf.

Também é possível modificar outros atributos do segredo arbitrário ao mesmo tempo, incluindo atributos de metadados como description, custom_metadata ou version_custom_metadata.

Girando segredos de chave-valor

Para girar um segredo de valor da chave usando o Terraform for Secrets Manager, modifique o valor do atributo data em sua configuração de recurso do ibm_sm_kv_secret e execute terraform apply para aplicar a mudança.. Se você estiver usando uma variável de entrada para a carga útil, modifique seu valor no arquivo variables.tf.

Também é possível modificar outros atributos do segredo de valor de chave ao mesmo tempo, incluindo atributos de metadados como description, custom_metadata ou version_custom_metadata.

Girando certificados importados

É possível girar certificados importados usando o Terraform for Secrets Manager.

Para girar um certificado importado, modifique os valores dos atributos certificate, intermediate (opcional) e private_key (opcional) em sua configuração de recurso do ibm_sm_imported_certificate e execute terraform apply para aplicar a mudança

Também é possível modificar outros atributos do certificado importado ao mesmo tempo, incluindo atributos de metadados como description, custom_metadata ou version_custom_metadata.

Implemente políticas de rotação de segredos com o Terraform IBM Modules (TIM) para Secrets Manager Secret para gerenciamento automatizado do ciclo de vida. Consulte Terraform IBM Modules(Módulos do Terraform ).