Integraciones y entrada de documentos Útil

Cambiar los permisos y los clientes de una clave de API

2:00 Tutorial 3.6

Los permisos y los clientes de una clave se cambian en pantallas propias. La clave no cambia: el integrador sigue usando la misma y los cambios se aplican en cada llamada.

Antes de empezar

  • Rol de titular o administrador del equipo. El resto de miembros no ve el submenú de API ni puede modificar claves.
  • Una clave activa. Una revocada no admite cambios.
  • Para añadir permisos, que el plan los incluya: los que no, salen deshabilitados con la etiqueta No incluido en el plan.

Paso 1. Abrir la ficha de la clave

En el menú lateral, Integraciones > API y desarrolladores > Claves de API. En la ficha, Permisos (1) y Clientes (2) abren cada pantalla; la cadena de candados indica cuántos tiene hoy.

Ficha de una clave con la cadena de candados Permisos y Clientes, y los botones Permisos (1) y Clientes (2).
Nota. Con Clientes en «No lee nada», la clave no tiene ningún cliente autorizado y no puede leer datos.

Paso 2. Marcar o desmarcar permisos

Pulsar Permisos. En Candado 1, Qué puede hacer, marcar los permisos necesarios y desmarcar los que sobren (1). Los que modifican datos llevan la etiqueta Escribe datos (2).

Pantalla Permisos con la lista de permisos marcados (1) y la etiqueta Escribe datos (2).
Importante. Una clave de pruebas lee con cualquier permiso, pero no escribe aunque lleve permisos que escriben.
Nota. Un permiso que la clave ya tenía y el plan actual no incluye se conserva, sin poder usarse, por si se vuelve a cambiar de plan.

Paso 3. Limitar las direcciones IP

Solo en los planes con configuración avanzada, el Candado 3, Desde qué direcciones, muestra Direcciones IP permitidas (1): una dirección o rango por línea, hasta 20.

Pantalla Permisos con el Candado 3 y el campo Direcciones IP permitidas (1).
Nota. Vacío, la clave funciona desde cualquier dirección. En planes sin esta opción, la lista que la clave ya tuviera se mantiene y no puede editarse.

Paso 4. Guardar los permisos

  1. Pulsar Guardar permisos (1).
  2. En el diálogo Guardar los permisos de «{nombre}», pulsar Sí, guardar (2).
Diálogo Guardar los permisos con el botón Sí, guardar (2) sobre la pantalla con Guardar permisos (1).
Importante. Los permisos añadidos se anotan, con la fecha de hoy, en la autorización de cada cliente de la clave. Los retirados dejan de poder usarse en el acto.
Nota. El aviso de resultado enumera lo añadido y lo quitado: «Permisos guardados. Añadidos: … Quitados: …».

Paso 5. Cambiar los clientes autorizados

  1. Desde la ficha, pulsar Clientes. Localizar el cliente con Buscar por nombre o NIF… (1).
  2. Marcar los clientes que la clave podrá ver y desmarcar los que deja de ver (2).
  3. Pulsar Guardar cambios (3) y confirmar con Sí, guardar.
Pantalla Clientes de la clave con el buscador (1), la lista de clientes con casillas (2) y el botón Guardar cambios (3).
Atención. Al desmarcar un cliente, la integración deja de ver sus datos en el acto y su consentimiento registrado queda revocado con fecha.
Nota. El buscador solo oculta filas: un cliente marcado que se sale del filtro sigue guardándose. Los accesos anteriores permanecen en el registro de llamadas.

Paso 6. Ampliar el techo de clientes

En claves de producción con techo, el panel Techo de clientes muestra el máximo. Indicar el valor en Nuevo techo (1) y pulsar Ampliar techo (2).

Panel Techo de clientes con el campo Nuevo techo (1) y el botón Ampliar techo (2).
Nota. Hasta la primera llamada de la integración el panel indica que el techo se podrá ampliar en cuanto la use. El nuevo valor no supera los clientes que admite el plan.
Importante. Ampliar el techo no autoriza a nadie: cada cliente nuevo se marca uno a uno en la lista.

Resultado

La clave conserva su secreto y refleja los cambios en la cadena de candados de su ficha. La integración los aplica en la llamada siguiente.

Campos de las pantallas

Campo Qué admite Obligatorio Efecto
Permisos (Qué puede hacer) Casillas del catálogo, salvo las que el plan no incluye Sí, al menos uno Concede o retira acciones en el acto.
Direcciones IP permitidas Una IP o rango por línea (IPv4 o IPv6), hasta 20 No Limita desde dónde funciona la clave. Vacío: cualquier IP.
Buscar por nombre o NIF… Texto libre No Filtra la lista de clientes; no cambia la selección.
Clientes (Sobre qué clientes) Clientes de la cartera No Sin ninguno marcado, la clave no lee nada.
Nuevo techo Número entero, entre el techo actual y los clientes del plan Sí, para ampliar Fija cuántos clientes admite la clave.

Problemas frecuentes

«Marcar al menos un permiso: una clave sin permisos no puede hacer nada. Si ya no se usa, revocarla.»
Dejar marcado al menos un permiso o revocar la clave.
«Esta clave tiene un techo de {n} clientes y la selección deja {m}. …»
Quitar clientes o ampliar el techo en la misma pantalla, una vez que la integración haya hecho su primera llamada.
«El techo se amplía cuando la integración ya ha hecho su primera llamada: …»
Esperar a que la integración use la clave por primera vez.
«El techo nuevo no puede ser menor que el actual ({n}).»
Indicar un valor igual o superior al actual y a los clientes ya autorizados.
«El techo no puede superar los clientes que admite el plan ({n}).»
Elegir un valor dentro del límite del plan o cambiar de plan.
«Esta clave no tiene techo de clientes que ampliar.»
El techo solo existe en las claves de producción creadas con él.
«Estas direcciones no son IP ni rangos válidos: …»
Corregir las líneas indicadas: una dirección o rango por línea.
El aviso indica que el plan no incluye un permiso y no se ha añadido.
El permiso no está en el plan actual. Marcar solo los habilitados o cambiar de plan.

Continuar con

Consejo
Marcar solo los permisos que la integración usa: si la clave se filtra, los permisos son lo único que limita el daño.
Anterior Crear una clave de API Siguiente Conectar carpetas de Drive para recibir justificantes

Prueba CopilotGestoria gratis

30 días gratis. Sube tu primera factura en 2 minutos.

Crear cuenta gratis