NetSuite でトークンベースの認証キーを生成
NetSuite トークンに基づく認証
Adaptive Planning とのインテグレーションのために設定した NetSuite ユーザーには、トークンベースの認証アクセスを持つロールが必要です。トークンベースの認証は以下に対して付与できます。- セキュリティのベスト プラクティスに従って、インテグレーションに必要な特定の権限のみを持つ新しいカスタム NetSuite ロール
- または既存の管理者 (ロール ID = 3) の Web サービスのロール
前提条件
- 管理者として NetSuite にログイン
- Adaptive Planning ですでに使用している NetSuite アカウント、E メール アドレス、および NetSuite のロールのレビュー
基本ステップ
- カスタム ロールを使用して Adaptive Planning を NetSuite と統合するか (推奨)、既存の管理者 (ロール ID = 3) ロールを使用するかを決定します。
Adaptive Planning とのインテグレーションのためのカスタム ロールを持つユーザーを構成 (推奨)
- NetSuite でトークンベースの認証をオンにします。
- 管理者のインテグレーション レコードを作成します。既存の "Adaptive Insights Integration" レコードを使用することはできません。
- Adaptive Planning とのインテグレーション設定のために認証情報が使用されるユーザーに、トークンベースの認証ロールを割り当てます。
- Adaptive Planning とのインテグレーションのためのアクセス トークンを作成します。
- Adaptive Planning ユーザー インターフェイスにキーを入力します。
Adaptive Planning とのインテグレーションのための既存の管理者 (ロール ID = 3) の構成
- NetSuite でトークンベースの認証をオンにします。
- 管理者のインテグレーション レコードを作成します。既存の "Adaptive Insights Integration" レコードを使用することはできません。
- 管理者用のユーザー アクセス トークンを作成します。
- Adaptive Planning ユーザー インターフェイスにキーを入力します。
カスタム ロールを使用して Adaptive Planning と NetSuite を統合するかどうかを決定する
ベスト プラクティスに従う場合は、NetSuite を Adaptive Planning とのインテグレーションのために必要な特定の権限 のみを持つカスタム ロールを作成します。このカスタム ロールにトークンベースの認証を付与します。引き続きインテグレーションに使用する管理者 (ロール ID = 3) がすでに存在する場合は、インテグレーション レコードとそのユーザー アクセス トークンを作成できます。管理者向けの手順は、この記事の末尾に記載されています。
Adaptive Planning とのインテグレーションのためのカスタム ロールを持つユーザーを構成 (推奨)
- 当該ロールに対して NetSuite でトークンベースの認証をオンにする
- "Setup" > "Company" > "Enable features" > "Suite Cloud" > "Manage Authentication"に移動し、"Token-Based Authentication"を選択します。
- "Setup" > "Users/Roles" > "Manage Roles"に移動して"New"をクリックし、新しいカスタム ロールを作成します。カスタム ロールに "Adaptive Planning Integration" という名前を付けます。
- トークンベースの認証を使用して Adaptive Planning とのインテグレーションに必要な権限を そのロールに付与し、"Setup > Log in Using Access Tokens - FULL" の権限を追加します。NetSuite Basic の権限については、この 記事をお読みください。NetSuite 拡張インテグレーションの場合 (インテグレーションの NetSuite データ ソース) は、これらの 一般的な権限を使用します。
- ロールを保存します。
- トークンベースの認証ロールの割り当て
- "Lists" > "Employees" > "Employees" > "Edit User"に移動し、Adaptive Planning 内でデータ インテグレーションを管理するユーザーを選択します。
- "Access" > "Roles"をクリックします。
- 作成したカスタム ロールをそのユーザーに割り当てます。
- "Setup" > "Integration" > "Manage Integrations" > "New"に移動します。
- "Adaptive Planning Integration" という名前を入力し、"Token-based Authentication" をクリックします。"State" が "Enabled" に設定されていることを再確認します。
- "Save"をクリックします。これにより、アクセス トークンの作成に使用するインテグレーション レコードが作成されます。
- インテグレーション レコードの次の値をコピーしてテキスト ファイルに貼り付け、将来アクセスできる安全な場所にファイルを保存します。
- アプリケーション ID (記録保持のみに使用されるもので、Adaptive Planning によって使用されることはありません)
- コンシューマー キー
- コンシューマー シークレット
このページから移動する前に、安全な場所に情報をコピーします。これは一度だけ表示され、後で取得することはできません。これらの値は、Adaptive Planning とのインテグレーションを完了するために必要です。次に、Adaptive Planning インテグレーションに関連付けられている NetSuite ユーザーに、アクセス トークンおよびアクセス トークン ID 値を生成します。- アクセス トークンの作成
- "Setup" > "Users/Roles" > "Access Tokens"に移動して"New"をクリックします。
- 前の手順で作成したアプリケーション名 "Adaptive Planning Integration" を選択します。
- ユーザーを選択してから、作成したロールを選択します。"Adaptive Planning Integration" を選択して、Adaptive Planning インテグレーション レコードを関連付けます。
- NetSuite が応答を生成します。アクセス トークン ID とアクセス トークンをコピーして、前の手順で作成した安全な場所に貼り付けます。
このページから移動する前に、応答をコピーします。これは一度だけ表示され、後で取得することはできません。これらの値は、Adaptive Planning とのインテグレーションを完了するためにも必要です。- Adaptive Planning にキーを入力
- インテグレーションの NetSuite データ ソースおよび NetSuite Basic の場合は、 次の手順に従ってキーを入力します。
Adaptive Planning とのインテグレーションのための既存の管理者 (ロール ID = 3) の構成
既存の管理者 (ロール ID = 3) の Web サービス ユーザーは、カスタム ロールとは異なる手順に従います。既存の管理者 (ロール ID = 3) が NetSuite 内でアクセス トークンを作成する場所も異なります。
- 管理者のインテグレーション レコードの作成
- 既存の管理者 (ロール ID = 3) の Web サービス ユーザーの場合、インテグレーション レコードの作成から開始します。
- "Setup" > "Integration" > "Manage Integrations" > "New"に移動します。
- "Adaptive Planning Integration" という名前を入力し、"Token-based Authentication" をクリックします。"State"が"Enabled"に設定されていることを再確認します。
- "Save"をクリックします。これで、アクセス トークンの生成に使用するインテグレーション レコードが作成されます。
- インテグレーション レコードの次の値をコピーしてテキスト ファイルに貼り付け、将来アクセスできる安全な場所にファイルを保存します。
- アプリケーション ID (記録保持のみに使用されるもので、Adaptive Planning によって使用されることはありません)
- コンシューマー キー
- コンシューマー シークレット
このページから移動する前に、安全な場所に情報をコピーします。これは一度だけ表示され、後で取得することはできません。これらの値は、Adaptive Planning とのインテグレーションを完了するために必要です。次に、Adaptive Planning インテグレーションに関連付けられている NetSuite ユーザーに、アクセス トークンおよびアクセス トークン ID 値を生成します。 - 管理者用のユーザー アクセス トークンの作成
- 管理者として NetSuite にログインします。
- 設定ポートレットで"Manage Access Tokens"をクリックします。
- "New My Access Token"をクリックします。
- アクセス トークンを関連付けるアプリケーション "Adaptive Planning Integration" を選択します。
- "Save"をクリックします。
- NetSuite が応答を生成します。アクセス トークン ID とアクセス トークンをコピーして、前の手順で作成した安全な場所に貼り付けます。
このページから移動する前に、安全な場所に情報をコピーします。これは一度だけ表示され、後で取得することはできません。これらの値は、Adaptive Planning とのインテグレーションを完了するために必要です。- Adaptive Planning にキーを入力
- インテグレーションの NetSuite データ ソースおよび NetSuite Basic の場合は、 次の手順に従ってキーを入力します。
- NetSuite でのトークンベースの認証監査ログの表示
- NetSuite の監査ログを表示して、ログイン試行中に Adaptive Planning からの正しいトークン要素が NetSuite に送信されているかを確認することができます。
- NetSuite にログインします。
- "Setup" > "Users/Roles" > "Login Audit Trail Search"に移動します。
- "Use Advanced Search"を選択します。
- "Results"タブを選択します。
- 結果に以下を追加します。
- トークンベースのアクセス トークン名
- トークンベースのアプリケーション名
- 詳細
- 検索を実行します。
- 最新のログインを一番上にして並べ替え、ログイン試行のステータス列と詳細列を確認します。