# コネクタ資格情報

Nexthinkがいかなるサードパーティ対応ツールにデータをエクスポートする前に、新しい認証情報を作成して定義し、その通信を可能にする必要があります。その後、Webhookやデータエクスポーターなどのアウトバウンドコネクターを設定する際に認証情報を適用します。

## 初めての認証情報の設定 <a href="#connectorcredentials-configuringcredentialsforthefirsttime" id="connectorcredentials-configuringcredentialsforthefirsttime"></a>

* メインメニューの「管理」 > 「コネクター資格情報」をクリックします。

「コネクター資格情報」ページは最初の資格情報設定を保存するまで空のままです。

{% hint style="info" %}
システムがメインメニューで「コネクター資格情報」オプションを表示しない場合は、この機能を有効化するために[Nexthinkサポート](https://support.nexthink.com/)に問い合わせてください。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-8286a6db616273e42122ae1cd8287a0a9df7b5b2%2Fint-1673360809.png?alt=media" alt="Accessing Connector credentials"><figcaption></figcaption></figure>

## 新しい資格情報の作成 <a href="#connectorcredentials-creatinganewcredential" id="connectorcredentials-creatinganewcredential"></a>

**Administration** > **Connector資格情報** pag&#x65;**:**

1. 「コネクター資格情報」ページの右上にある「新しい資格情報」ボタンをクリックします。
2. 資格情報設定の入力フィールドに記入してください:

* **名前**: 資格情報の一意の名前。
* **プロトコル** オプション:
  * **Hypertext Transfer Protocol Secure (HTTPS)**。 以下の[HTTPS コネクタ資格情報](#connectorcredentials-connectorcredentialsforhttpshttpsprotocol)セクションを参照してください。
  * **セキュアファイル転送プロトコル (SFTP)**。 以下の [SFTP のコネクタ資格情報](#connectorcredentials-connectorcredentialsforsftpcredentialsftp) セクションを参照してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-f16c737852c0adcb0efecd247dda9fed0bf651d3%2Fint-1673360905.png?alt=media" alt=""><figcaption></figcaption></figure>

## HTTPS のコネクタ資格情報 <a href="#connectorcredentials-connectorcredentialsforhttpshttpsprotocol" id="connectorcredentials-connectorcredentialsforhttpshttpsprotocol"></a>

1. **プロトコル**のドロップダウンメニューから **ハイパーテキスト・トランスファー・プロトコル・セキュア（HTTPS）** を選択します。
2. サードパーティツールのURLを使用して**URLアドレス**を追加します。

* `https://{host}:{port}/` フォーマットに従うよう確認してください。
* 適切な[認証タイプ](#connectorcredentials-supportedauthorizationmechanismsauthorizationtype)を選択し、入力フィールドに情報を入力します。

3. 資格情報設定を[保存](#connectorcredentials-savinganewcredentialsavingcredential)します。

次の表には、**URLアドレス**入力フィールドを追加するためのURL例が含まれています。

{% hint style="info" %}
各サードパーティツールは、インスタンスURLを異なる方法で構築します。 サードパーティソフトウェアのドキュメントを参照して、挿入するURLの値を確認してください。
{% endhint %}

| サードパーティツール        | Full URL                                                           | インスタンスURL（資格情報フィールド）                     |
| ----------------- | ------------------------------------------------------------------ | ---------------------------------------- |
| ServiceNow        | `https://<instancename>.service-now.com/api/now/table/{tableName}` | `https://ven01063.service-now.com/`      |
| BMC               | `https://serverName:port/api/arsys/v1/entry/{formName}`            | `https://serverName:port/`               |
| Ivanti            | `https://{tenant url}/api/rest/ServiceRequest/new`                 | `https://{tenant url}/`                  |
| Freshservice      | `https://api.freshservice.com/v1/#update_ticket_priorityを参照してください` | `https://api.freshservice.comを参照してください/` |
| 4me               | `https://api.4me.com/v1/requestsを参照してください`                         | `https://api.4me.comを参照してください/`          |
| Jira Service Desk | `https://<instancename>.atlassian.net/rest/servicedeskapi/request` | `https://<instancename>.atlassian.net/`  |

### サポートされている認証メカニズム <a href="#connectorcredentials-supportedauthorizationmechanismsauthorizationtype" id="connectorcredentials-supportedauthorizationmechanismsauthorizationtype"></a>

**認証タイプ**のドロップダウンから認証メカニズムを選択し、タイプに応じて関連する入力フィールドに入力します。

* **ベーシック**認証：サードパーティツールに接続するためのユーザー名とパスワードを入力します。
* **ベアラートークン**認証： **ヘッダープレフィックス**は手動で設定できますが、指定されていない場合はデフォルトで\_Bearer\_ として入力されます。
  * **トークン**フィールドにAPIトークンを入力してください。 これらのトークンは通常サードパーティツールによって生成され、要求が開始されたときにヘッダーに自動的に追加されます。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-6940371b22104572167d6ad838da4e7f545a2424%2Fscreenshot-2021-11-03-at-08-52-47.png?alt=media" alt="Bearer token authorizations"><figcaption></figcaption></figure>

* **OAuth 2.0 - クライアント資格情報** 認証： 通常のユーザー名とパスワードの代わりに **クライアントID** と **クライアント秘密鍵** を使用してトークンを取得します。 両方の値が必要です。
  * トークンの有効期限が切れ、更新が必要です。 **アクセストークン URL** フィールドを設定して、現行のトークンが期限切れになったときに自動で新しいトークンを要求します。
  * **スコープ**はオプションのフィールドで、**クライアントID**と**クライアント秘密鍵**を使用してシステムがターゲットマシンで実行する操作を一覧表示します。
  * **認証情報** は、人や法人の代理としてトークンを許可および取得するリクエストを支援します。OAuthトークンのリクエストは **ヘッダー** または **ボディ** に設定できます。
    * Nexthink は、認証を**ボディ**に保存することを推奨していません。これはリクエストコメント (RFC) 標準に準拠していません。
  * [カスタムヘッダー](#custom-header) が、認証のための追加情報を提供します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-3f59cad9eb7ee0706570f0da980ccb09c23630c5%2FConnector%20-%20Credentials.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
クライアント秘密鍵に特殊文字が含まれている場合、システムはそれらをURLエンコードして送信します。 サードパーティツールがURLエンコードをサポートしていない場合、**ボディ**を選択してリクエストボディにクライアント資格情報を送信してください。 これにより、エンコードに関連する 4xx エラーを回避できます。
{% endhint %}

* **OAuth 2.0 - 認可コード**認証： クライアントIDとクライアント秘密を使用してトークンを取得します。 両方の値が必要です。
  * サードパーティツールは、認可コードをNexthinkに送信するために**リダイレクトURL**を使用します。 コピー機能を使ってリダイレクトURLをコピーし、サードパーティツールに追加してください。
  * トークンの有効期限が切れ、更新が必要です。 現在のトークンの有効期限が切れたときに自動的に新しいトークンをリクエストするように**認証コードURL**フィールドと**アクセストークンURL**フィールドを設定します。
  * **スコープ**はオプションのフィールドで、**クライアントID**と**クライアント秘密**を使用してシステムがターゲットマシンで実行する操作を一覧表示します。
  * [カスタムヘッダー](#custom-header) が、認証のための追加情報を提供します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-c54944f25fa2dce44a7dd004f244c6c9122e7b03%2FConnectors-auth-code..png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Nexthink は、認証をボディに保存することを推奨していません。これはRFC規格に準拠していません。
{% endhint %}

* **認証なし**： サードパーティツールに接続するためのURLを入力します。 これは通常、着信ウェブフックURLに使用されます。

### カスタムヘッダー

OAuth 2.0 認証方式において、**Client Credentials**や**Authorization Code**などの追加資格情報を含めるために**カスタムヘッダー**を使用します。 デフォルトのOAuth 2.0認証メカニズムを超えて追加の認証方法が必要な場合に便利です。

**カスタムヘッダーを追加**して、**OAuth 2.0 - クライアント資格情報**または**OAuth 2.0 - 認可コード** 認証に追加情報を含めてください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-55de238b52a89f62d586d1c7e0f3527caf07edd0%2FConnector%20-%20001.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

ゴミ箱アイコンをクリックして、既存のカスタムヘッダーを削除します。

## SFTPのコネクタ資格情報 <a href="#connectorcredentials-connectorcredentialsforsftpcredentialsftp" id="connectorcredentials-connectorcredentialsforsftpcredentialsftp"></a>

**プロトコル**のドロップダウンから\*\*セキュアファイル転送プロトコル (SFTP)\*\*を選択します。

* **ホスト名：** 接続するSFTPサーバーのホスト名を `sftp://{hostname}:{port}/` の形式で入力します。 プロトコル `sftp` と `port` を含める必要があります。
* **SFTPサーバーフィンガープリント：** これにより、ユーザーやクライアントアプリケーションはSSHまたはSFTPサーバーを認証し、意図されたサーバーに接続しているかどうかを判断できます。 サポートされているホストキーアルゴリズムは次のとおりです：
  * `rsa-sha2-512`
  * `rsa-sha2-256`
  * `ecdsa-sha2-nistp256`
  * `ecdsa-sha2-nistp384`
  * `ecdsa-sha2-nistp521`
  * `ssh-rsa` は乗算ハッシュアルゴリズムがSHA1ではない場合のみサポートされています（廃止されました）。

{% hint style="warning" %}
`da:47:93:b4:3a:90:5b:50:1f:20:a8:f9:b7:a1:d0:e1` などの値は、このフィールドには無効です。

アルゴリズム `ssh-ed25519` は現在サポートされていません。
{% endhint %}

{% hint style="info" %}
アルゴリズム `ssh-ed25519` は現在サポートされていません。
{% endhint %}

* **認証：** ドロップダウンリストから認証タイプを選択してください。
  * **ベーシック：** ユーザー名とパスワードを入力してSFTPサーバーに接続します。
  * **SSHキー：** ユーザー名とSSHキー（オプションでパスフレーズ）を入力してSFTPサーバーに接続します。

## 新しい資格情報を保存する <a href="#connectorcredentials-savinganewcredentialsavingcredential" id="connectorcredentials-savinganewcredentialsavingcredential"></a>

資格情報の入力フィールドに情報を入力した後、**保存** をクリックして新しい資格情報を作成してください。

もし必要なら、情報を入力フィールドから削除するために**キャンセル**をして、新しい資格情報の作成を中止してください。

{% hint style="info" %}
資格情報設定フィールドが無効な場合、システムはエラーメッセージを表示します。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-7c2df6f63ac6111d565f867343cc0e20d2734374%2Fnxcheseaux-20230619-111641-20230619-091655.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## 資格情報を編集する <a href="#connectorcredentials-editingacredential" id="connectorcredentials-editingacredential"></a>

**管理** > **コネクタ認証情報** ページe\*\* から:\*\*

1. 資格情報テーブルの資格情報アイテムの右側にある鉛筆アイコンをクリックしてください。

* クリックすると、事前入力された値を含む資格情報設定ページにリダイレクトされます。
* **トークン**または**パスワード**フィールドはセキュリティ上の理由から表示されず、コピーできません。 下の画像をご覧ください。

2. 資格情報構成に対して行った編集を**保存**します。

* 変更を**キャンセル** して **コネクタ資格確認** ページに戻ります。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-5954f650b7dfd20db044bf82b27b2ffb79384722%2Fscreenshot-2021-11-03-at-09-18-49.png?alt=media" alt="" width="517"><figcaption></figcaption></figure>

## 資格情報の削除 <a href="#connectorcredentials-deletingacredential" id="connectorcredentials-deletingacredential"></a>

**管理** > **コネクタ認証情報** ページe\*\* から:\*\*

1. 資格情報テーブルの資格情報アイテムの右側にあるゴミ箱アイコンをクリックしてください。
2. **ウェブフック資格情報の削除** ポップアップから削除を確認してください。

システムはコネクタとのリンクがあるかどうかにかかわらず資格情報を削除します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-513c9f25f63d29877845f198217fc515a6a70826%2Fscreenshot-2022-02-07-at-16-12-45.png?alt=media" alt=""><figcaption></figcaption></figure>

***

関連するリンク

* [インテグレーション](..)
* [インバウンドコネクタ](../inbound-connectors)
* [アウトバウンドコネクタ]()
