Criando um bloqueio na versão atual do segredo

Você pode bloquear a versão atual de um segredo usando a UI Secrets Manager. Uma solicitação bem-sucedida anexa um novo bloqueio à versão atual de seu segredo selecionado ou substitui um bloqueio de mesmo nome se ele já existir.

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 correspondente ao segredo que você deseja bloquear, clique no menu “ Ações ” > Bloqueios > Criar bloqueio.
5. Adicione um nome e uma descrição para identificar facilmente a trava.
6. A partir da lista de versões para bloquear, selecione Atual.
7. Opcional: Anexar atributos JSON para o seu bloqueio. Você pode incluir um objeto JSON com cada bloqueio para guardar qualquer informação que você possa precisar para um fluxo automatizado. Por exemplo, um par de valor chave que identifica o recurso que você deseja associar a esse bloqueio.
8. Opcional: Faça o bloqueio exclusivo. Escolha esta opção para remover quaisquer outros bloqueios que combinem com o nome que você forneceu. Se quaisquer bloqueios de correspondência forem encontrados na versão anterior do segredo, esses bloqueios são excluídos quando seu novo bloqueio for criado.
9. Opcional: Excluir os dados da versão anterior. Escolha esta opção para também excluir permanentemente os dados da versão secreta anterior se ele não tiver bloqueios que estejam associados a ele.
10. Clique em Criar. Um novo bloqueio é criado para a sua versão secreta selecionada.

Como criar um bloqueio na versão secreta anterior

Você pode bloquear a versão anterior de um segredo usando a UI Secrets Manager. Uma solicitação bem-sucedida anexa um novo bloqueio à versão anterior do seu segredo selecionado ou substitui um bloqueio de mesmo nome se ele já existir.

3. Na IU Secrets Manager, acesse a lista Segredos.
4. Na linha correspondente ao segredo que você deseja bloquear, clique no menu “ Ações ” > Bloqueios > Criar bloqueio.
5. Adicione um nome e uma descrição para identificar facilmente a trava.
6. A partir da lista de versões para bloquear, selecione Anterior.
7. Opcional: Anexar atributos JSON para o seu bloqueio. Você pode incluir um objeto JSON com cada bloqueio para guardar qualquer informação que você possa precisar para um fluxo automatizado. Por exemplo, um par de valor chave que identifica o recurso que você deseja associar a esse bloqueio.
8. Clique em Criar. Um novo bloqueio é criado para a sua versão secreta selecionada.

Criando um bloqueio na versão atual do segredo

É possível bloquear a versão atual de um segredo usando a CLI do Secrets Manager. Uma solicitação bem-sucedida anexa um novo bloqueio à versão atual de seu segredo selecionado ou substitui um bloqueio de mesmo nome se ele já existir.

Para criar um bloqueio na versão atual de um segredo usando o plug-in da CLI Secrets Manager, execute o comando ibmcloud secrets-manager secret-locks-bulk-create. É possível especificar o tipo de segredo, o ID do segredo e o modo.

ibmcloud secrets-manager secret-locks-bulk-create \
    --id=exampleString \
    --locks='[{"name": "lock-example-1", "description": "lock for consumer 1", "attributes": {"anyKey": "anyValue"}}]' \
    --mode=remove_previous

Criando bloqueios na versão secreta atual

A solicitação a seguir cria dois bloqueios na versão atual de um 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.

curl -X POST
-H "Authorization: Bearer {iam_token}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
      "locks": [
        {
          "name": "lock-1",
          "description": "Lock for consumer 1.",
          "attributes": {
            "key": "value"
          }
        },
        {
          "name": "lock-2",
          "description": "Lock for consumer 2.",
          "attributes": {
            "key": "value"
            }
          }
        ]
      }' \
    "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/locks_bulk"

Se você está construindo um fluxo automatizado, você pode usar o objeto attributes para especificar dados de valor chave com cada bloqueio em seu segredo. Por exemplo, você pode incluir um identificador de recursos, como um ID ou Nome de Recurso em Nuvem (CRN).

Uma resposta bem-sucedida retorna detalhes sobre os novos bloqueios, juntamente com outros metadados.

{
  "secret_id": "0cf4addb-7a90-410b-a3a7-a15bbe2b7909",
  "secret_group_id": "d8371728-95c8-4c12-b2af-1af98adb9e41",
  "versions": [
    {
      "version_id": "7bf3814d-58f8-4df8-9cbd-f6860e4ca973",
      "version_alias": "current",
      "locks": [
        "lock-3",
        "lock-4"
      ],
      "payload_available": true
    },
    {
      "version_id": "5bf89b0c-df55-c8d5-7ad6-8816951c6784",
      "version_alias": "previous",
      "locks": [
        "lock-1",
        "lock-2"
      ],
      "payload_available": true
    }
  ]
}

Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, consulte a Referência de API.

Como criar bloqueios na versão secreta anterior

A solicitação a seguir cria dois bloqueios na versão anterior de um 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.

curl -X POST
    -H "Authorization: Bearer {iam_token}" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -d '{
      "locks": [
        {
          "name": "lock-1",
          "description": "Lock for consumer 1.",
          "attributes": {
            "key": "value"
            }
          },
          {
            "name": "lock-2",
            "description": "Lock for consumer 2.",
            "attributes": {
              "key": "value"
              }
            }
          ]
        }' \ "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions/{version_id}/locks_bulk"

Uma resposta bem-sucedida retorna detalhes sobre os novos bloqueios, juntamente com outros metadados.

{
  "secret_id": "0cf4addb-7a90-410b-a3a7-a15bbe2b7909",
  "secret_group_id": "d8371728-95c8-4c12-b2af-1af98adb9e41",
  "versions": [
    {
      "version_id": "7bf3814d-58f8-4df8-9cbd-f6860e4ca973",
      "version_alias": "current",
      "locks": [
        "lock-3",
        "lock-4"
      ],
      "payload_available": true
    },
    {
      "version_id": "5bf89b0c-df55-c8d5-7ad6-8816951c6784",
      "version_alias": "previous",
      "locks": [
        "lock-1",
        "lock-2"
      ],
      "payload_available": true
    }
  ]
}

Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, consulte a Referência de API.