> ## 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.
> Auth0 Actions Modulesの使用方法を説明します
# 初めてのAction Moduleを作成する
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};
};
## はじめに
このクイックスタートでは、Action Module を作成し、Action から利用して外部サービスにログを送信する方法を説明します。
特定のActionでAction Moduleを使用するには、まずAction Moduleを作成し、その後Actionに追加して使用する必要があります。
1. [Auth0 Dashboard > Actions > Library](https://manage.auth0.com/#/actions/library) に移動し、**Modules** を選択します。
2. **Create Module** を選択します。
3. **名前** を入力します。
4. **Create** を選択します。
Code Editor が表示されます
各 Action Module には、シークレットのキーと値のペアを含めることができます。これらを使用して、API キー、証明書、環境ごとに変わる可能性のある値などの機密情報を保持します。
外部サービスの URL をシークレットとして保存しましょう。
1. コードエディターの左側のサイドバーにある **** アイコンを選択します。
2. **Add Secret** を選択します。
3. **名前** に `SERVICE_URL` を入力します。
4. **値** フィールドに外部サービスの URL を入力します。
5. **Create** を選択します。
Auth0 により、シークレットが Action Module のシークレット一覧に追加されます。
**追加手順:** `API_KEY` もシークレットとして保存するには、同じ手順を繰り返します。これは各リクエストのヘッダーに含めて外部サービスに送信します。
シークレットを作成すると、Auth0 がその値を表示することはありません。Auth0 はすべてのシークレットを暗号化し、安全に保存します。
各 **Action Module Secret** は、ほかの **Actions Modules** および **Actions Secrets** とは独立しています。
Action Module で **Secrets** を使用するには、`actions.secrets.[secret_key]` と入力します。
次に、Action Module に次のコードを追加します。
Action Module に次のコードを追加します。
```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;
}
};
```
次の点に注意してください。
* [コーディングガイドライン](/ja/docs/customize/actions/action-coding-guidelines#actions-modules)
* [制限事項](/ja/docs/customize/actions/limitations#actions-modules)
Action Module の下書きを保存できます。
1. **Save Draft** を選択します。
これにより、Action Module は新しいバージョンを公開せずに保存されるため、これを使用している Actions には影響しません。
Action Module のコードに問題がなければ、次はそれを**公開**します。
1. **公開**を選択します。
Action Module を公開すると、その時点のスナップショットが取得され、**Action Module Version**として記録されます。
2. **バージョン履歴を表示**を選択します。
Auth0 に、ドラフトを含む Action Module Version の一覧が表示されます。
これで、Action で Action Module を使い始めることができます。
各**Action**は**Action Module Version**を明示的に参照する必要があります。これにより、予期しないエラーにつながる可能性のある自動アップグレードを防げます。
Action に Action Module を追加してみましょう。
1. [Auth0 Dashboard > Actions > Library](https://manage.auth0.com/#/actions/library) に移動し、目的の **Action** を選択します。
2. Action Editor を開いたら、左側のサイドバーで **** アイコンを選択します。
3. **Add Module** を選択します。
4. モジュールの**名前**と**バージョン**を選択します。
5. **追加** を選択します。
それでは、Action 内で Action Module を使用してみましょう。
1. **require** 文を追加します。
```javascript lines theme={null}
const logger = require('actions:logger');
```
**require** 文では、**actions:\[module-name]** 形式で Action Module を参照します。
2. ログを送信したい箇所の **Action 関数** に、`logger.sendLog` の呼び出しを追加します。
```javascript lines theme={null}
await logger.sendLog('logger_success', 'Your Action was able to use the Logger Action Module');
```
3. Action の **Deploy** を選択します。
Action は必ず Trigger にバインドしてください。
**チェックポイント**
これで、**Action** で使用する、完全に機能する **Action Module** の準備が整いました。
***
## 高度な使用方法
各**Action Module**には、\*\*[NPM 依存関係](https://www.npmjs.com/)\*\*を追加して使用できます。
1. コードエディターの左側のサイドバーで\*\*\*\*アイコンを選択します。
2. **Add Dependency**を選択します。
3. **NPM パッケージ**の**名前**を入力します。
4. **NPM パッケージ**の**バージョン**を入力します。
5. **Create**を選択します。
Auth0 によって、依存関係が Action Module の依存関係リストに追加されます。
一覧に表示されている**依存関係**は、`require('[package-name]')`で読み込むことで Action Module で使用できます。
この Action を保存すると、Auth0 は依存関係の最新バージョンを解決し、今後のパッケージ更新で Action が動作しなくなるのを防ぐために、特定のバージョン番号に置き換えます。
latest の代わりに特定のバージョンを指定することもできます。