> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Describe cómo usar los módulos de Actions en Auth0
# Crea tu primer módulo de Action
export const AuthCodeGroup = ({children, dropdown}) => {
const [processedChildren, setProcessedChildren] = useState(children);
useEffect(() => {
let unsubscribe = null;
function init() {
unsubscribe = window.autorun(() => {
const processChildren = node => {
if (typeof node === "string") {
let processedNode = node;
for (const [key, value] of window.rootStore.variableStore.values.entries()) {
const escapedKey = key.replaceAll(/[.*+?^${}()|[\]\\]/g, (String.raw)`\$&`);
processedNode = processedNode.replaceAll(new RegExp(escapedKey, "g"), value);
}
return processedNode;
} else if (Array.isArray(node)) {
return node.map(processChildren);
} else if (node && node.props && node.props.children) {
return {
...node,
props: {
...node.props,
children: processChildren(node.props.children)
}
};
}
return node;
};
setProcessedChildren(processChildren(children));
});
}
if (window.rootStore) {
init();
} else {
window.addEventListener("adu:storeReady", init);
}
return () => {
window.removeEventListener("adu:storeReady", init);
unsubscribe?.();
};
}, [children]);
return {processedChildren};
};
## Primeros pasos
Use la guía de inicio rápido para escribir un módulo de Action y usarlo desde una Action para enviar registros a un servicio externo.
Para usar un módulo de Action en una Action específica, primero debes crear el módulo de Action y luego agregarlo o usarlo en una Action.
1. Ve a [Auth0 Dashboard > Actions > Library](https://manage.auth0.com/#/actions/library) y luego selecciona **Modules**.
2. Selecciona **Create Module**.
3. Introduce un **Name**.
4. Selecciona **Create**.
Auth0 muestra el editor de código
Cada Action Module puede contener pares clave/valor de secretos. Úsalos para almacenar información confidencial, como claves de API, certificados y valores que pueden variar entre entornos.
Almacenemos la URL del servicio externo como un Secret.
1. Selecciona el ícono **** en la barra lateral izquierda del editor de código.
2. Selecciona **Add Secret**.
3. Introduce `SERVICE_URL` como **nombre**.
4. Introduce la URL del servicio externo en el campo **Value**.
5. Selecciona **Create**.
Auth0 agrega el Secret a la lista de Secrets del Action Module.
**Paso adicional:** Repite los pasos para almacenar un `API_KEY` como Secret que enviarás en los encabezados al servicio externo con cada solicitud.
Una vez que creas un Secret, Auth0 nunca vuelve a mostrar su valor. Auth0 cifra todos los Secrets y los almacena de forma segura.
Cada **Action Module Secret** es independiente de los **Actions Modules** y **Actions Secrets**.
Usa **Secrets** en el Action Module escribiendo `actions.secrets.[secret_key]`.
Ahora, añada el siguiente código a su módulo de Action.
Añada el siguiente código a su módulo de Action:
```javascript lines theme={null}
module.exports = {
sendLog: async (code, message) => {
try {
await fetch(actions.secrets.SERVICE_URL, {
method: 'POST',
headers: {
'X-API-Key': actions.secrets.API_KEY,
},
body: JSON.stringify({
code,
message
}),
});
console.log({
code,
message
});
} catch (err) {
throw new Error('External service failure');
}
return;
}
};
```
Tenga en cuenta:
* [Pautas de codificación](/es/docs/customize/actions/action-coding-guidelines#actions-modules)
* [Limitaciones](/es/docs/customize/actions/limitations#actions-modules)
Puedes guardar un borrador de tu módulo de Action.
1. Selecciona **Save Draft**.
Esto guarda el módulo de Action como borrador sin publicar una nueva versión, por lo que no afecta a las Actions que lo usan.
Una vez que estés conforme con el código del Action Module, es momento de **publicarlo**.
1. Selecciona **Publicar**.
Al publicar un Action Module, se crea una instantánea de ese momento y se registra como una **versión del Action Module**.
2. Selecciona **Ver historial de versiones**.
Auth0 muestra la lista de versiones del Action Module, incluido el borrador.
Ahora puedes empezar a usar el Action Module en una Action.
Cada **Action** debe hacer referencia explícitamente a la **versión del Action Module**, lo que evita actualizaciones automáticas que podrían introducir errores inesperados.
Agreguemos el módulo de Action en una Action.
1. Vaya a [Auth0 Dashboard > Actions > Library](https://manage.auth0.com/#/actions/library) y, a continuación, seleccione una **Action** específica.
2. Una vez en el editor de Action, selecciona el ícono **** en la barra lateral izquierda.
3. Seleccione **Add Module**.
4. Seleccione el **nombre** y la **versión** del módulo.
5. Selecciona **Agregar**.
Ahora, usemos el Action Module en la Action.
1. Agrega la instrucción **require**.
```javascript lines theme={null}
const logger = require('actions:logger');
```
La instrucción **require** hace referencia al Action Module con el formato **actions:\[module-name]**.
2. Agrega la llamada a `logger.sendLog` en la **función Action**, donde quieras enviar registros.
```javascript lines theme={null}
await logger.sendLog('logger_success', 'Your Action was able to use the Logger Action Module');
```
3. Selecciona **Deploy** para la Action.
Recuerda vincular la Action a un Trigger.
**Punto de control**
Ahora debería tener un **módulo de Action** completamente funcional que ya utiliza una **Action**.
***
## Uso avanzado
Cada **módulo de Action** puede agregar y usar **[dependencias de NPM](https://www.npmjs.com/)**.
1. Selecciona el icono **** de la barra lateral izquierda del editor de código.
2. Selecciona **Agregar dependencia**.
3. Introduce el **nombre** del **paquete NPM**.
4. Introduce la **versión** del **paquete NPM**.
5. Selecciona **Crear**.
Auth0 agrega la dependencia a la lista de dependencias del módulo de Action.
Usa las **dependencias** de la lista en el módulo de Action importándolas con `require('[package-name]')`.
Cuando guardas esta Action, Auth0 resuelve la versión más reciente de tu dependencia y la sustituye por un número de versión específico para evitar que futuras actualizaciones del paquete hagan que tu Action deje de funcionar.
Puedes indicar una versión específica en lugar de la más reciente.
Auth0 agrega el Secret a la lista de Secrets del Action Module.
Auth0 muestra la lista de versiones del Action Module, incluido el borrador.
Auth0 agrega la dependencia a la lista de dependencias del módulo de Action.