> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/xpay-enablement/ja/api-rifarensu/sekyuriti/no.md).
# 接続性の概要
Thalesが公開するすべてのAPIは、接続において **TLS相互認証**が必要です。これはThalesからのインバウンドおよびアウトバウンドのAPIの両方に当てはまります。
TLS接続の設定はセットアップの最初のステップであり、Thalesサービスの構成を行う前に実施する必要があります。トークン化サービスはすべてのAPIに対して一意のエンドポイントを持ちます。つまり、TLS接続の設定はすべてのThalesサービスに対して一度だけ行われます。
APIの利用者として、あなたは「**customer**」または「**actor**」として知られており、そのために **トークン化サービス内の顧客識別子** を持ちます。この識別子は重要です。なぜならTLS接続はそれぞれの **トークン化サービス内の顧客識別子**.
環境ごとに明示的に確立する必要があり、それぞれが分離されているからです：
* プレプロダクション
* プロダクション
あなたのホストからThales TSHへのインカミングフロー
| エンドポイント | 環境 |
| ------------------------------------------------------------------------------------------------- | -------- |
|
| Pre-Prod |
| [https://api.dbp.thalescloud.io](https://api.dbp.thalescloud.io/) | Prod |
TSH APIにアクセスするには、Thales CAによってあなたのTLSクライアント証明書に署名してもらう必要があります。そのために、署名のための証明書署名要求（CSR）をThales担当者に提出する必要があります。
#### 一般的な要件：
1. アルゴリズム：RSA暗号（4096ビット）またはECDSA P-256鍵とSHA256ハッシュ。
2. コモンネーム（CN）：形式と値はThalesによって強制およびチェックされます。値は以下の例のステップ2に記載されたパターンに従う必要があります。
#### CSR生成の例
対象とする各環境（プレプロダクションおよびプロダクション）について次の手順を繰り返してください。
1. CSRのために新しい鍵ペア（RSAまたはECDSA）を生成してください。
次のOpenSSLコマンドでRSA 4096鍵ペアを作成できます：
```shellscript
openssl req -new -newkey rsa:4096 -nodes -keyout private_rsa.key -out issuer_pp.csr -subj "/C=/ST=/L=/O=/OU=/CN=TLSMA-RSA\/\/TSH\/TSP."
```
次のOpenSSLコマンドでECDSA P-256鍵ペアを作成できます：
```shellscript
openssl ecparam -name prime256v1 -genkey -noout -out tsh-mtls-client-cert.key
openssl req -new -key tsh-mtls-client-cert.key -out tsh-mtls-client-cert.csr -subj "/C=/ST=/L=/O=/OU=/CN=TLSMA-ECDSA\/\/TSH.\/TSP."
```
ここで：
* *country* はイシュアの国を意味します。
* *state* はイシュアの州を意味します。
* *locality* はイシュアの所在地（ローカリティ）を意味します。
* *Organization Name* はイシュアイシュア組織名でなければなりません。
* *Organizational Unit* はイシュアの組織単位でなければなりません。
* *CN* はコモンネームを意味します。
* *tspId* はThales担当者から提供されるIDです。
* *env* はこの証明書が対象とする環境です。プレプロダクションの場合： `PPR`、プロダクションの場合： `PRD`
* *ECDSAとRSAの違い* はCN内の鍵の種類に依存します。
{% hint style="info" %}
イシュアのバックエンドは常にTSHドメイン名とそのサブドメインを解決する必要があります。Thales TSHは長期の静的IPをサポートしていないため、Thalesの顧客はTSHのIPアドレスをDNSのTTLより長い期間ハードコードしたりキャッシュしたりしないでください。
{% endhint %}
Thales TSHからあなたのホストへのアウトゴーイングフロー
一般的な要件：
1. 相互認証
2. TLS 1.2（以上）
3. あなたのサーバーはポート443（または8443。ただし443が推奨）で稼働している必要があります。
4. インターネット経由（IPホワイトリストは不要）
5. 当社のクライアント証明書を認証するために、あなたはThales Client CAを信頼する必要があります。当社のClient CAはTSHポータル（イシュア向け）からダウンロード可能で、マーチャントに対しては手動で交換されます。必要に応じて、ThalesはTSPによって署名されるための新しい鍵ペアを生成できます。
6. Thales TSHはあなたのサーバー証明書を信頼する必要があり、そのためにあなたはTSHポータル（イシュア向け）を通じて、またはマーチャントとは手動で交換する形でサーバーのCAチェーンを提供して承認してもらう必要があります。
あなたは当社のClient CAのみを承認し、クライアント証明書を「ピン」してはなりません。当社のクライアント証明書は当社のClient CAによって署名されています。TSHは有効期限前であっても予告なくクライアント証明書を更新する場合があります。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.payments.thalescloud.io/xpay-enablement/ja/api-rifarensu/sekyuriti/no.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.