Secretos
Las credenciales con las que tus operaciones llaman al exterior se guardan en un vault dentro del proyecto. Un valor se almacena cifrado (el detalle está en la página de seguridad), se direcciona por referencia y se mantiene fuera de tus archivos de configuración.
Etiquetas y referencias
Un secreto tiene una etiqueta que eliges y un propietario: el proyecto, una app o uno de tus usuarios. Al crearlo se devuelve una referencia opaca, y esa referencia es la forma de direccionarlo a partir de entonces. Puedes guardar uno en la consola, en Settings, con la CLI, o confirmando un archivo foir.secrets.ts que declara etiquetas y no contiene texto plano, y que foir secrets push reconcilia con el proyecto.
Cómo se lee un valor
Para un endpoint que alojas tú, el token de envío que llega con la llamada ya concede la lectura. El manejador llama a getSecret con la referencia y un propósito, y no guarda credenciales propias. El propósito es obligatorio y queda registrado.
Para una llamada que hace Fóir por sí mismo, la plantilla de la petición se refiere a un secreto mediante un nombre de marcador, y un enlace en la operación asocia ese nombre con la referencia. El valor se resuelve en el momento de la llamada y nunca se almacena en la operación.
Quién puede tener acceso
Los alcances para secretos pueden tenerlos las claves de API secretas y nunca las claves públicas. Una operación que desencadena uno de tus usuarios puede almacenar un secreto que ese usuario posee, y solo las operaciones de ese usuario lo leen de vuelta.
Rotación y eliminación
Rotar sustituye el valor detrás de una referencia existente. Quienes lo leen reciben el valor nuevo en su siguiente lectura, y no hay que volver a desplegar nada. Eliminar es una eliminación lógica: el secreto deja de resolverse al instante y puede restaurarse durante 30 días.
Lee el detalle
La guía de secretos cubre cómo almacenar, leer y rotar un secreto, los secretos que posee un usuario y lo que se audita.