---
schema_version: "1"
id: c11c945a3c92460f2703b95f8205a510d83af260e8c4cd45d1ac8657b4988352
title: デトークナイゼーションポリシー
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-gateway/policies-included-detokenization.md
canonical_url: https://docs.mulesoft.com/jp/mule-gateway/policies-included-detokenization
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 49ba9b4a19c13e10067223bfeed8ac67a282d77cb96d1d5c951a03a8e0190951
description: MuleSoft Documentation Site
latest: true
---
# デトークナイゼーションポリシー

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>ポリシー名</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デトークナイゼーション</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>概要</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トークナイズされた値を元の値に戻します。このポリシーは、Anypont Runtime Fabric のデプロイメントでのみ機能するように設計されています。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>カテゴリ</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>セキュリティ</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>使用可能な最小 Mule バージョン</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>v4.1.1</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-right valign-middle" rowspan="3"><p class="tableblock"><strong>返される状況コード</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-right valign-middle" rowspan="3"><div class="content"><div class="paragraph">
<p>400</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>指定した式が無効であるか、デトークナイズする結果を返さない。</p>
</div>
<div class="paragraph">
<p><strong>NOTE</strong>​: 返される状況コードを設定することができます。</p>
</div></div></td>
</tr>
</tbody>
</table></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>502 - トークナイゼーションサービスへの接続が使用できないか、設定されていない。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#概要)概要

デトークナイゼーションは、以前にマスクされた機密データを元の値に戻すプロセスで、機密情報の漏洩リスクを減らします。データをトークナイズして、機密情報をトークンに置き換え、機密情報の漏洩リスクを減らすことができます。

たとえば、クレジットカードの月次報告書を生成する場合、アプリケーションから銀行口座番号やクレジットカード番号が要求されることがあります。デトークナイズされた機密データは、必ず厳格なセキュリティ制御の下で読み取る必要があります。

## [](#前提条件)前提条件

デトークナイゼーションポリシーを適用し、管理するには、以下が必要です。

- **「Manage Policies (ポリシーの管理)」**​権限の取得
- [トークナイゼーションサービスを設定し、使用する](https://docs.mulesoft.com/jp/anypoint-security/tokenization-example)​には、以下が必要です。
    
    - Runtime Fabric のインストール
    - **「Manage Tokenization Services (トークナイゼーションサービスの管理)」**​権限の取得
- 稼働中のトークナイゼーションサービス

## [](#スコープと考慮事項)スコープと考慮事項

このポリシーを適用する前に、次の考慮事項を確認してください。

- ポリシーの 1 つのインスタンスでは、トークナイゼーションサービスが 1 つだけサポートされます。
    
    設定した形式はすべて同じトークナイゼーションサービスに含まれている必要があります。
- ポリシーの 1 つのインスタンスを使用して、要求と応答の両方ではなく、どちらか一方の値をトークナイズできます。
- トークナイゼーションサービスを削除した場合、またはトークナイゼーションサービスが稼働していない場合、ポリシーはサービスとの通信を確立できません。これにより、サービスが再び使用可能になるまで、すべての要求が失敗します。
- ポリシー設定時のサービスメニューには、使用できるトークナイゼーションサービスのみが表示されます。
    
    目的のサービスが表示されない場合、すでにデプロイされているかどうかを確認してください。

## [](#ポリシーのパラメーターの設定)ポリシーのパラメーターの設定

### [](#mule-ゲートウェイ)Mule ゲートウェイ

このポリシーを API に適用するときに、以下の項目が UI に表示されます。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">要素</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Direction (方向)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求と応答 (デフォルト) のどちらからデトークナイズする値が抽出されるのか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Fail on unmatched expressions (式の不一致により失敗)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択すると、式とトークンが一致しない場合に要求が失敗する。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サービス</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>現在の組織と環境で使用可能なトークナイゼーションサービス。リストから必要なサービスを選択します。使用可能な形式は、選択したサービスによって異なります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>式</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デトークナイズされる情報を抽出するために使用するセレクター式。</p>
</div>
<div class="paragraph">
<p>次に例を示します。</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-expression hljs" data-lang="expression">#[payload.people.creditCardNumber]</code></pre>
</div>
</div>
<div class="paragraph">
<p>項目の区切り文字としてドットを使用する式のみが許可されています。​<code>[payload.people.creditCardNumber]</code>​ は有効ですが、​<code>#[payload[‘people’]]</code>​ は無効です。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ<br>
セレクター式を指定しない場合、ポリシーは適用されますが、ペイロードからは何もデトークナイズされません。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>形式</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デトークナイズされる情報の種別。形式は選択したサービスによって異なる場合があります。リストから形式を 1 つ選択します。</p>
</div>
<div class="paragraph">
<p>リストに形式が表示されない場合、選択したトークナイゼーションサービスに少なくとも 1 つの形式が含まれていることを確認してください。<br>
詳細は、​<a href="https://docs.mulesoft.com/jp/anypoint-security/tokenization-formats" class="xref page">「トークナイゼーション形式」</a>​記事を参照してください。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ<br>
形式を指定しない場合、ポリシーは適用されますが、ペイロードからは何もデトークナイズされません。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#ポリシーのしくみ)ポリシーのしくみ

デトークナイゼーションポリシーは、ペイロード内のトークナイズされた情報を元の値に戻します。ペイロード内のどのデータをデトークナイズするのかを定義するには、セレクター式を指定する必要があります。

**例**

ポリシーを受信するペイロードに次の構造が含まれているとします。

```JSON
{
  "name":"Amun Ra",
  "socialSecurityNumber":"167-47-9268"
}
```

社会保障番号 (socialSecurityNumber) をデトークナイズする場合、次のセレクター式を使用して、ポリシーによってトークナイズされる情報を指定できます。

```expression
#[payload.socialSecurityNumber]
```

このセレクターを使用すると、最上位レベルに ​`socialSecurityNumber`​ キーを含む要求をポリシーが受信するたびに、指定した式に一致するトークンがすべて抽出されます。次にトークナイゼーションサービスとの接続が確立され、ペイロード内のトークナイズされた値が元の値に置き換えられます。

例の社会保障番号のデトークナイズされた値が ​_365-93-2738_​ だった場合、アプリケーションは次のペイロードを受信します。

```json
{
  "name":"Amun Ra",
  "socialSecurityNumber":"365-93-2738"
}
```

ペイロードの要求または応答の値をデトークナイズするようにデトークナイゼーションポリシーを設定できます。

### [](#要求のデトークナイズ)要求のデトークナイズ

要求をデトークナイズすると、次のイベントが発生します。

![セキュリティ、トークナイゼーション、Mule アプリケーション間のデータフローを示す図](/mulesoft/current/ja-jp/mule-gateway/_images/policy-mule4-tokenization-67b25.png)

1. ユーザーがポリシーで保護されたアプリケーションに要求を実行します。
2. 要求は最初に Anypoint Security に送信され、その後アプリケーションのデトークナイゼーションポリシーに送信されます。
3. デトークナイゼーションポリシーにより、セレクター式を使用してトークンがペイロードから抽出されます。
4. デトークナイゼーションサービスは、トークンを受信して元の機密値に戻し、その結果をポリシーに送信します。
5. ポリシーによってトークナイズされたペイロードがデトークナイズされた値に置き換えられ、Mule アプリケーションに転送されます。
6. Mule アプリケーションは要求を処理して結果を返します。

### [](#応答のデトークナイズ)応答のデトークナイズ

応答をデトークナイズすると、次のイベントが発生します。

![トークナイゼーションサービスのデータフローを示す図](/mulesoft/current/ja-jp/mule-gateway/_images/policy-mule4-tokenization-9347d.png)

1. ユーザーがポリシーで保護されたアプリケーションに要求を実行します。
2. 要求は最初に Anypoint Security に送信され、その後アプリケーションのデトークナイゼーションポリシーに送信されます。
3. デトークナイゼーションポリシーはペイロードから何も抽出せずに要求をリダイレクトします。
4. Mule アプリケーションは要求を処理して結果を返します。
5. デトークナイゼーションポリシーにより、セレクター式を使用してトークンがペイロードから抽出されます。
6. デトークナイゼーションサービスは、トークンを受信して元の機密値に戻し、その結果をポリシーに送信します。
7. ペイロード内にデトークナイズされた値を含む応答がポリシーからユーザーに返されます。

## [](#関連情報)関連情報

- [トークナイゼーションサービス](https://docs.mulesoft.com/jp/anypoint-security/tokenization)
- [デトークナイゼーションポリシーリリースノート](https://docs.mulesoft.com/jp/release-notes/policies/detokenization-release-notes)