Saltar al contenido
Verificada

Buenas prácticas con las claves de API

Acceso completo frente a personalizado, revocar y reemplazar una clave, y detectar una que nadie usa.

Una clave de API actúa en tu cuenta sin ti: desde cualquier lugar, hasta que se revoca. Autenticación explica cómo se crea una clave y cómo se envía en una llamada; esta página trata de mantener en orden las que ya tienes.

Da a una clave solo lo que necesita

Toda clave es de Acceso completo o de Acceso personalizado, se elige al crearla y se puede cambiar después desde el mismo formulario.

  • Acceso completo llega a todos los métodos que tu cuenta puede llamar, incluidos los añadidos después de crear la clave. Nada marcado como privado se incluye nunca, sea cual sea el modo de acceso de una clave.
  • Acceso personalizado llega solo a los métodos que has marcado explícitamente, agrupados por microservicio con los parámetros de cada método a su lado. Un método añadido más tarde no queda cubierto hasta que vuelvas a marcarlo.
Prefiere el acceso personalizado para todo lo automatizado

Una clave integrada en un script, en un trabajo de CI o en un servidor solo necesita los pocos métodos que ese trabajo llama de verdad. El acceso personalizado evita que una clave filtrada pueda hacer más que el trabajo para el que se creó.

Crear, mostrar y copiar

Crear una clave exige que tu cuenta esté verificada al nivel 2; consulta Verificación. El botón Crear clave lo explica y te lleva directamente al siguiente paso pendiente si todavía no has llegado. El valor de una clave recién creada se muestra una sola vez en el panel de Copia rápida de la parte superior de la lista; después, cada fila lo mantiene oculto, y el botón de mostrar de la propia fila lo muestra de nuevo durante 20 segundos antes de volver a ocultarlo solo.

Una clave es un secreto, no una etiqueta

El valor nunca se escribe en un registro, en un aviso ni en la barra de direcciones, solo en tu portapapeles. Trátalo exactamente como una contraseña. Cualquiera que lo tenga puede actuar como tu cuenta.

Reemplazar, revocar y detectar una que no se usa

No hay una acción de rotación aparte, porque el valor de una clave es su propio identificador. Reemplazar crea una clave nueva con el mismo nombre y acceso, revoca la anterior y muestra el valor nuevo una sola vez para que puedas copiarlo antes de cerrar el cuadro de diálogo. Revocar elimina una clave por completo y te pide que la confirmes por su nombre antes, ya que no se puede deshacer.

La fila de cada clave muestra cuándo se usó por última vez, a partir de los últimos 7 días de actividad; una clave sin línea debajo simplemente no hizo ninguna llamada en esa ventana. Esa es la fila que merece una segunda mirada.

Reemplaza una clave que pueda haberse filtrado

Abre la clave, pulsa Reemplazar y copia el valor nuevo en cuanto aparezca. El valor antiguo deja de funcionar en el instante en que termina el reemplazo.

Revoca una clave que ya no necesitas

Pulsa Revocar en su fila y confirma por su nombre. Una clave revocada desaparece de la lista de activas; no hay forma de recuperarla.

Comprueba si hay alguna que nadie usa

Revisa la lista en busca de una fila sin línea de "Último uso", sobre todo entre las claves de Acceso completo, y revócala si no sabes explicar para qué sirve.