お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

エンタープライズ向け機能
認証情報は、エンタープライズのお客さまのみが利用でき、要求に応じて提供されます。有効にするには、サポートチームにメールでお問い合わせください。

認証情報モジュールでは、データベース、リモートマシン、アプリケーションサーバーの認証情報を効率的に保存、管理できます。複数のタスクでユーザー名、パスワード、APIキーを繰り返し入力する代わりに、一度保存して必要に応じて再利用できます。

認証情報は一元管理用の保管場所に暗号化形式で保存され、タスクの実行時にBridgeによって自動的に使用されます。これにより、手作業が軽減され、認証情報が漏洩するリスクを最小限に抑えられます。

組織のセキュリティ設定に応じて、認証情報はQntrlのクラウド、またはBridge経由でオンプレミス環境に保存できます。

認証情報のメリット 

セキュリティの強化：認証時にパスワードやAPIキーなどの機密情報が漏洩するリスクを最小限に抑え、許可された対象だけがリソースを使用できるようにすることで、セキュリティを強化します。

 

簡単なアクセス：ユーザー名やパスワードを手動で入力する必要がありません。認証情報名を指定するだけで、必要なリソースにすばやく簡単にアクセスできます。

 

アクセス制御：認証情報を使用することで、管理者はユーザーやアプリケーションに特定の権限を付与し、必要な機能だけにアクセスできるように制限できます。

 

一元管理：すべての認証情報を1か所に保存することで、管理が簡素化され、必要に応じて簡単に更新または変更できます。

 

監査と説明責任：ユーザーやアプリごとに固有の認証情報を使用することで、追跡や監査、不審な活動やセキュリティ侵害の特定が容易になります。

 

暗号化と復号 

認証情報は暗号化形式で安全に保存されるため、一度入力するとアクセスできなくなります。入力したデータは、転送時にはTLS、保存時には256ビットAES暗号化によって暗号化されます。 

1. ベーシック - パスワードを暗号化
2. APIキー - トークンを暗号化
   
3. JDBC認証情報の種類 - パスワードを暗号化
4. SSH認証情報の種類 - パスワードを暗号化
5. PowerShell認証情報の種類 - パスワードを暗号化
6. AD認証情報の種類 - パスワードを暗号化
   
7. NTLM - パスワードを暗号化
   

Qntrlの暗号化ポリシーについて詳しくはこちら。

権限の設定 

認証情報へのアクセスと使用には権限が必要です。メッセージの実行に認証情報を使用できるのは、適切な権限を持つユーザーのみです。初期設定では、認証情報を作成したユーザーが使用できます。他のユーザーが認証情報を使用するには、そのユーザーの［プロフィール］セクションで認証情報へのアクセスを有効にする必要があります。

対応している認証情報の種類

Bridgeでは、さまざまなサービスやリソースに安全にアクセスできるよう、複数の種類の認証情報を利用できます。認証情報の種類ごとに用途が異なり、固有のパラメーターがあります。

ベーシック

ベーシック認証情報は、ユーザー名とパスワードを渡してSOAP要求を認証するために使用します。こちらで作成したベーシック認証情報は、SOAP呼び出しを行う際にBridgeで使用できます。

項目：

• ［ユーザー名］／［パスワード］：SOAP要求の認証に使用するアカウントのユーザー名とパスワードです。
  

APIキー

APIキーは、API要求を行うアプリケーションまたはユーザーを識別するための固有のコードです。APIキーの生成時に定義したスコープに基づき、データの取得、更新、または特定の処理を行うAPIへのアクセス権が付与されます。こちらで作成したAPI認証情報は、Bridge、Circuit、APIルックアップ項目、およびWebhookで使用できます。

項目：

1. ［トークン］：API要求の送信先サービスで生成されたトークンです。
   
2. ［ヘッダー］：APIトークンやその他の認証情報を格納するHTTPヘッダーの名前です。APIトークンで一般的に使用されるヘッダー名は次のとおりです。
   
1. Authorization
   
2. API-Key
   
3. Bearer
   
3. ［パラメーター］：API要求時にAPIトークンを渡すために使用するクエリパラメーターまたは要求本文パラメーターの名前です。

認証情報の作成  

1. 左側のパネルで設定の歯車アイコン（⚙）をクリックします。
2. ［詳細設定］→［認証情報］に移動します。
3. ［新しい認証情報］ボタンをクリックします。
4. 新しい認証情報の詳細を入力します。
5. ［名前］：認証情報を識別する一意の名前を入力します。
6. ［種類］：認証情報の種類を選択します。下に表示される項目は、選択した認証情報の種類によって異なります。各種類の詳細については、認証情報の種類セクションを参照してください。
• ［基本］-ユーザー名とパスワードを入力します。
• ［APIキー］-APIトークンを入力し、パラメーターまたはヘッダーとして追加するかを選択して、名前を指定します。
• ［JDBC］-JDBC認証情報の種類では、ユーザー名とパスワードを入力します。
• ［OAuth 2.0］-既存のDRE接続を選択します。
• ［SSH］-シェルスクリプトを実行するマシンのユーザー名とパスワードを入力します。
• ［PowerShell］-PowerShellスクリプトを実行するマシンのユーザー名とパスワードを入力します。
• ［Active Directory］-Active DirectoryのユーザーDNとパスワードを指定します。
• ［NTLM］-ユーザー名、パスワード、ドメイン、ホスト名を入力します。
7. ［アクセスの種類］：認証情報の保存場所と、タスク実行時の取得方法を決定します。選択したアクセスの種類に応じて、追加の項目が表示されます。実行時、Bridgeは選択したアクセスの種類から認証情報を自動的に取得し、使用します。
• ［ネイティブ］：認証情報はQntrlデータベースに安全に保存されます。
• ［Bridge］：認証情報はBridgeのインストール環境にローカル保存されるため、環境外に出ることはなく、実行時にのみ取得されます。
• ［認証情報モジュール］：タスク実行時に、外部ストレージまたはサービスからシークレットを動的に取得します。
• ［サーバースクリプト］：実行時にサーバースクリプトを使用して認証情報を取得します。実行前に外部サービスから認証情報の値を取得する必要がある場合に便利です。
8. ［範囲］：範囲は、サンドボックス内の複数の環境で認証情報がどのように動作するかを決定します。たとえば、認証情報名は同じまま、サンドボックスと本番環境で異なるDBパスワードを使用できます。選択した範囲に応じて、環境固有の値を入力するための関連項目が表示されます。
• ［グローバル］：すべての環境で同じ認証情報の値を使用します。
• ［環境］：環境ごとに個別の値を設定できます。
9. ［グループ］：アクセスを制限するには、認証情報をグループに割り当てます。そのグループに関連付けられているユーザーまたはモジュールのみが認証情報を使用できます。グループの詳細はこちらをご参照ください。
10. ［すべてのモジュール］：すべてのモジュールを有効にすると、フルアクセスを許可できます。無効にすると、ドロップダウンからモジュールを手動で選択できます。
11. ［許可するモジュール］：この認証情報にアクセスできるモジュールを制御します。
12. ［保存］をクリックします。

• カスタムモジュールの実装では、機密値（パスワード／トークン）をログに記録しないでください。ログから漏えいする可能性があります。
• サーバースクリプト内で機密性の高い認証情報データを出力したり、ログに記録したりしないでください。
  

認証情報の編集   

既存の認証情報の詳細を更新するには、以下の手順を実行します。

1. ［設定］（⚙）→［詳細設定］ →［認証情報］に移動します。

2. 編集する認証情報の名前をクリックして選択します。

3. 開いた認証情報ページで変更を加え、［保存］をクリックします。 

認証情報の削除   

既存の認証情報を削除するには、以下の手順を実行します。

1. ［設定］（⚙）→［詳細設定］→ ［認証情報］に移動します。

2. 削除する認証情報の名前にカーソルを合わせ、［操作メニュー］をクリックし、 続いて［削除］を選択します。

3. 削除操作を確認します。