前提条件
前提条件の構成
DuoKey BYOK統合のためのSalesforceコンポーネントを構成する
プレビュー
Salesforce Shield 連携はプレビュー段階であり、標準の DuoKey Cockpit テナントではまだ有効になっていません。このガイドでは仕組みと設定手順を説明します。プロジェクトでのご利用については DuoKey にお問い合わせください。
適用対象:
Salesforce SetupConnected AppSelf-Signed CertificateREST API Credentials
概要
前提条件には次が含まれます。
- SalesforceでConnected Appを作成する
- 自己署名証明書を生成する
- REST API認証情報を取得する
ステップ1：Connected Appの作成
Connected Appは、REST APIを介してDuoKeyとSalesforce間のセキュアな通信を確立します。
1
App Managerへの移動
- Salesforceアカウントにログインします
- Setupの歯車アイコンをクリックします
- Quick Findで「App Manager」を検索します
- Apps → App Managerに移動します
2
新しいConnected Appの作成
- New Connected Appボタンをクリックします
- 基本情報を入力します：
| Field | Value |
|---|---|
| Connected App Name | DuoKey BYOK Integration |
| API Name | (自動入力) |
| Contact Email | [email protected] |
3
OAuth設定の構成
- Enable OAuth Settingsをチェックします
- コールバックURLを設定します：
sfdc://oauth/restapi/success - Selected OAuth Scopesで次を追加します：Full access (full)
- Saveをクリックします
注記
コールバックURL sfdc://oauth/restapi/successは、Salesforce REST API統合の標準です。
4
Consumer KeyとSecretの取得
- App Managerから、新しく作成したConnected Appを見つけます
- ドロップダウン矢印 (▼) をクリックし、Viewを選択します
- API (Enable OAuth Settings)セクションで、Manage Consumer Detailsをクリックします
- メールに送信された検証コードを入力します
- 次を安全にコピーして保存します：
- Consumer Key (Client ID)
- Consumer Secret (Client Secret)
警告
これらの認証情報を安全に保管してください。DuoKeyアプリケーションを構成する際に必要になります。
ステップ2：自己署名証明書の生成
Salesforceでは、Cache-Only Key ServiceとのBYOK統合に自己署名証明書が必要です。
1
証明書管理への移動
- Salesforceのセットアップで、Quick Findで「Certificate」を検索します
- Security → Certificate and Key Managementに移動します
2
自己署名証明書の作成
- Create Self-Signed Certificateをクリックします
- 証明書の詳細を入力します：
| Field | Value | Note |
|---|---|---|
| Label | DuoKey BYOK Certificate | わかりやすい名前 |
| Unique Name | (自動入力) | または手動で入力 |
| Key Size | 4096 | セキュリティのために推奨 |
| Exportable Private Key | チェック | バックアップ/移行を有効化 |
ヒント
「Exportable Private Key」を有効にすると、バックアップまたは移行の目的で必要な場合に証明書をエクスポートできます。
Saveをクリックします
ステップ3：REST API認証情報の取得
Salesforceのユーザー名とパスワード
これらは標準のSalesforceログイン認証情報です。
- ユーザー名：Salesforceアカウントのメール
- パスワード：Salesforceアカウントのパスワード
セキュリティトークンの生成
1
セキュリティトークンのリセット
- 右上のプロフィールアイコンをクリックします
- Settingsを選択します
- Quick Findで「Reset My Security Token」を検索します
- My Personal Information → Reset My Security Tokenに移動します
- Reset Security Tokenをクリックします
- 新しいセキュリティトークンについてメールを確認します
- セキュリティトークンを安全にコピーして保存します
注意
- セキュリティトークンはメールで送信され、機密として保管する必要があります
- パスワードを変更すると、セキュリティトークンは自動的にリセットされます
- API認証には最新のセキュリティトークンを使用する必要があります
Salesforceドメイン/インスタンス
- Setup Home → Company Settings → My Domainに移動します
- ドメイン名（例：
yourcompany.develop.lightning.force.com）をメモします - インスタンスエイリアス（例：
yourcompany）を抽出します
認証情報の概要
| Credential | Description | Example |
|---|---|---|
| Consumer Key | Connected AppのOAuth設定から | 3MVG9...（長い文字列） |
| Consumer Secret | Connected AppのOAuth設定から | 12345...（数値文字列） |
| Salesforceユーザー名 | Salesforceのログインメール | [email protected] |
| Salesforceパスワード | Salesforceアカウントのパスワード | YourP@ssw0rd |
| Security Token | Reset My Security Tokenから | ABC123...（英数字） |
| ドメイン/インスタンス | Salesforceドメインエイリアス | yourcompany |
| 証明書 | 自己署名証明書名 | DuoKey BYOK Certificate |
ヒント
これらの認証情報を安全に保管するために、セキュアなパスワードマネージャーの使用を検討してください。
検証チェックリスト
前提条件が完了
Connected AppOAuth有効で作成済み
Consumer認証情報KeyとSecretを取得済み
証明書4096ビット鍵を作成済み
セキュリティトークンメールで取得済み