Oracle Netsuite の認証

UiPath Integration Service は、カスタム認証の種類による NetSuite トークンベースの認証をサポートしています。詳しくは、NetSuite の公式ドキュメント「 Token-Bating」をご覧ください。

注:

トークンベースの認証を使用するには、1 つのロールにリンクされた新しいユーザーを設定する必要があります。 既存のユーザーには複数のロールがあり、Web サービスで使用されるロールが Web サービス ロールとして選択されたロールと一致しない場合があります。

前提条件

トークンベースのカスタム認証を使用して認証するには、次の資格情報を指定する必要があります。

• コンシューマー キー
• 消費者の秘密
• アクセス トークン ID
• アクセス トークン シークレット
• アカウント ID

また、アカウントに対してトークンベースの認証を有効にし、アプリケーションの統合レコードを作成し、関連するロールを作成し、ユーザーにロールを割り当て、資格情報/トークンを生成する必要があります。

NetSuite への接続の作成に必要な設定を完了するには、NetSuite アカウントで次の手順を実行します。

アカウントに対してトークンベースの認証を有効にする

1. NetSuite にサインインし、[ 会社>設定] に移動して [機能を有効化>。
2. [SuiteCloud] タブで、[Manage Authentication] セクションまで下にスクロールします。
3. トークンベースの認証を有効化し、[保存] を選択します。

アプリケーションの統合レコードを作成する

1. [設定] に移動し、[連携] > [連携を管理] > [新規] を選択して連携を作成します。

2. 連携 の名前を入力します 。

3. [ 認証 ] セクションで、次の手順を実行します。

   1. トークンベースの認証と TBA: トークンの発行エンドポイントを有効化します。
   2. 未定: 認可フローと認可コードの付与を無効にします。
   3. ユーザー資格情報を有効化します。

4. [保存] を選択します。

   

5. 統合を保存すると、コンシューマーキーとシークレットが表示されます。 これらの値を取得できる機会はこの時しかありません。

   

ユーザー ロールの作成と割り当て

1. [ ユーザー/ロール>設定] > [ロールを管理] > [新規 ] に移動して、トークンベースの認証ユーザー用の新しいカスタム ロールを作成します。
2. [ ロール ] ページで、次の手順を実行します。

   1. ロール の名前を入力します 。

   2. [権限] セクションの [設定] タブで、[ユーザー アクセス トークンと SOAP Web サービス] 権限を追加します。また、連携のニーズと範囲に基づいて、関連する権限を追加します。利用可能な権限の詳細については、Netsuite の ドキュメントをご覧ください。

   3. [保存] を選択します。

      

      

3. ロールが正常に作成されたら、[ Lists] > [Employees] > [Employees] に移動します。既存の従業員コンポーネントを選択するか、新しい従業員コンポーネントを作成します。
4. [従業員] ページの [>ロールにアクセスする] セクションで、作成したロールを割り当てます。[ロール] メニューから選択し、[追加] を選択します。ロールを割り当てたら、[ 保存 ] を選択します。

トークンを生成する

1. [ ユーザー/ロール] > [アクセス トークン] > [新規] > [設定] に移動します。

2. [ アクセス トークン ] ページで、前の手順で作成したアプリケーション、ユーザー、およびロールを選択します。トークンの名前を追加し、[ 保存] を選択します。

3. トークン ID とシークレットが表示されます。 トークン ID とシークレットが表示されるのはこの時だけです。

   

アカウント ID を取得する

1. [セットアップ] ページから [会社] に移動します。
2. [ 会社情報] で [ アカウント ID] を選択します。アカウント ID は URL にも記載されています。たとえば、URL が https://12345XYZ.app.netsuite.com/の場合、アカウント ID は 12345XYZです。注: アカウント名はホスト名の規則に従う必要があり、文字 (A から Z)、数字 (0 から 9)、ハイフン (-)、ピリオド (.) のみを含める必要があります。システムの制約により、アンダースコア (\_) は使用できません。

[Show Internal IDs] を有効化する

NetSuite のドキュメントに説明されている手順に従って、[Show Internal IDs] 設定を有効化します。

この設定では、NetSuite のすべてのフィールド、レコード、リスト、ワークフロー アクション、カスタム フォームの内部 ID を表示できます。オブジェクトの内部 ID は、NetSuite アクティビティでは必須の入力プロパティです。

Oracle NetSuite コネクションを追加する

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. 必要な資格情報を入力し、[接続] を選択します。

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

同時実行の制限

NetSuite の同時実行制限により、アカウントの同時要求制限の一部を特定の連携に割り当てることができます。各アカウントには、Web サービスに対していつでも実行できる要求の数に制限があります。詳細については、 NetSuite の同時実行数の制限 に関するドキュメントをご覧ください。

既定では、NetSuite コネクタは、使用する同時セッションを 5 に制限します。この値は、[ 連携>設定] > [連携の管理] で変更できます。連携を選択し、[ 編集 ] ボタンを選択して、[ 同時実行の制限] に新しい値を入力します。

重要:

この制限により、別のユーザーが同じ資格情報を使用している場合に、一部のアクティビティの呼び出しが失敗する可能性があります。オートメーション用に個別の資格情報セットを保持することをお勧めします。