Crear un bloqueo en la versión secreta actual

Puede bloquear la versión actual de un secreto utilizando la interfaz de usuario de Secrets Manager. Una solicitud correcta adjunta un nuevo bloqueo a la versión actual del secreto seleccionado, o sustituye un bloqueo del mismo nombre si ya existe.

1. En la consola, pulse el icono Menú > Lista de recursos.

2. En la lista de servicios, seleccione la instancia de Secrets Manager.

3. En la interfaz de usuario de Secrets Manager, vaya a la lista Secretos.

4. En la fila del secreto que desea bloquear, haga clic en el menú Acciones > Bloqueos > Crear bloqueo.

5. Añada un nombre y una descripción para identificar fácilmente la cerradura.

6. En la lista de versiones a bloquear, seleccione Actual.

7. Opcional: adjunte atributos JSON al bloqueo.

   Puede incluir un objeto JSON con cada bloqueo para contener cualquier información que pueda necesitar para un flujo automatizado. Por ejemplo, un par de clave-valor que identifica el recurso que desea asociar con este bloqueo.

8. Opcional: haga que el bloqueo sea exclusivo.

   Elija esta opción para eliminar cualquier otro bloqueo que coincida con el nombre que ha proporcionado. Si se encuentran bloqueos coincidentes en la versión anterior del secreto, estos bloqueos se suprimen cuando se crea el nuevo bloqueo.

9. Opcional: Borrar los datos de la versión anterior.

   Elija esta opción para suprimir también de forma permanente los datos de la versión secreta anterior si no tiene ningún bloqueo asociado.

10. Pulse Crear.

Se crea un nuevo bloqueo para la versión secreta seleccionada.

Creación de un bloqueo en la versión secreta anterior

Puede bloquear la versión anterior de un secreto utilizando la interfaz de usuario de Secrets Manager. Una solicitud satisfactoria adjunta un nuevo bloqueo a la versión anterior del secreto seleccionado o sustituye un bloqueo del mismo nombre si ya existe.

3. En la interfaz de usuario de Secrets Manager, vaya a la lista Secretos.

4. En la fila del secreto que desea bloquear, haga clic en el menú Acciones > Bloqueos > Crear bloqueo.

5. Añada un nombre y una descripción para identificar fácilmente la cerradura.

6. En la lista de versiones a bloquear, seleccione Anterior.

7. Opcional: adjunte atributos JSON al bloqueo.

   Puede incluir un objeto JSON con cada bloqueo para contener cualquier información que pueda necesitar para un flujo automatizado. Por ejemplo, un par de clave-valor que identifica el recurso que desea asociar con este bloqueo.

8. Pulse Crear.

   Se crea un nuevo bloqueo para la versión secreta seleccionada.

Crear un bloqueo en la versión secreta actual

Puede bloquear la versión actual de un secreto utilizando la CLI Secrets Manager. Una solicitud correcta adjunta un nuevo bloqueo a la versión actual del secreto seleccionado, o sustituye un bloqueo del mismo nombre si ya existe.

Para crear un bloqueo en la versión actual de un secreto utilizando el plugin de CLI Secrets Manager, ejecute el mandato ibmcloud secrets-manager secret-locks-bulk-create. Puede especificar el tipo de secreto, el ID de secreto y la modalidad.

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

Creación de bloqueos en la versión secreta actual

La solicitud siguiente crea dos bloqueos en la versión actual de un secreto. Cuando llame a la API, sustituya las variables de ID y la señal de IAM por los valores que son específicos de la instancia de 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"

Si está creando un flujo automatizado, puede utilizar el objeto attributes para especificar datos de valor de clave con cada bloqueo en el secreto. Por ejemplo, puede incluir un identificador de recurso, como un ID o un nombre de recurso de nube (CRN).

Una respuesta satisfactoria devuelve detalles sobre los nuevos bloqueos, junto con otros metadatos.

{
  "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 obtener más información sobre los parámetros de solicitud necesarios y opcionales, consulte el apartado Referencia de API.

Creación de bloqueos en la versión secreta anterior

La solicitud siguiente crea dos bloqueos en la versión anterior de un secreto. Cuando llame a la API, sustituya las variables de ID y la señal de IAM por los valores que son específicos de la instancia de 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"

Una respuesta satisfactoria devuelve detalles sobre los nuevos bloqueos, junto con otros metadatos.

{
  "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 obtener más información sobre los parámetros de solicitud necesarios y opcionales, consulte el apartado Referencia de API.