NetSuite トークン認証へのコネクター

NetSuite® Token Authentication コネクターを使用すると、NetSuite と対話するためにチェーンでコマンドを使用することができます。例えば、このコネクターを使えば、次のことができる：

NetSuiteからのファイルダウンロード
NetSuiteに保存された検索を一覧表示します。
NetSuiteの標準レコードまたは保存検索に関するデータを取得します。

メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。

前提条件

接続を有効にするには、コネクターは NetSuite REST API を使用します。コネクターの設定には、以下のものが必要だ：

トークン・ベース認証（TBA）が有効なNetSuite
接続する NetSuite アカウントの ID
メモ: NetSuite でアカウント ID を表示するには、セットアップ 、統合、Web サービス設定 を選択します。IDは通常URLの最初の文字列、app.netsuite.com の直前にも表示されます。
コネクター用に NetSuite で作成した統合レコードとアクセストークン
統合レコードの消費者キーとシークレット
メモ： 消費者シークレットまたはキーがない場合は、統合レコードを編集し、資格情報をリセットします。
使用するアクセストークンのIDとシークレット。アクセストークンのIDやパスワードをお持ちでない場合は、新規作成が必要です。

メモ: OAuth 2.0 認証を使用して NetSuite RESTlet と対話するには、代わりにHTTP リクエストコネクターを使用します。

NetSuiteで統合を有効にする

コネクターが NetSuite と対話できるようにするには、トークン認証（TBA）と独自の統合レコードが必要です。

ステップ1.SOAPウェブサービスとトークンベースの認証を有効にする

NetSuiteのSOAPウェブサービスとTBAを有効にする：

NetSuite では、セットアップ 、会社、機能の有効化 を選択します。
SuiteCloudタブで、SuiteScript の下で、Client SuiteScript とServer SuiteScript を選択します。
SuiteTalk (Web Services) の下で、SOAP web services を選択します。
Manage authentication で、Token-based authentication を選択する。
[保存]をクリックします。

ステップ2.統合記録の作成

TBA を有効にしたら、コネクターの統合レコードを作成します：

NetSuiteでセットアップ、統合、統合管理、新規を選択します。
統合の識別をヘルプするために、Workiva Integration のようなユニークな名称と説明を入力します。
認証の下でトークン・ベース認証を選択し、TBA：作成者フローをクリアします。
保存をクリックし、確認ページから消費者キーとシークレットを記録する。

注：消費者キーとシークレットは、統合記録の確認ページ（）上にのみ表示されます。コネクターのプロパティには必ずこれらの値を記録し、パスワードのように扱ってください。

ステップ3.統合ロールの作成

セキュリティのため、統合を管理する専用の役割を NetSuite で作成してください：

選択セットアップ,ユーザー/役割,役割の管理,新規.
General の下に、Workiva/NetSuite Integration のように、役割を識別するのに役立つ一意の名称を入力します。
認証で、Web サービスのみの役割を選択し、NetSuite API のみに接続する役割を有効にし、 NetSuite に直接ログインしないようにします。
権限の下に権限を追加し、NetSuiteの関連するすべての権限トランザクション、レポート、リストなどの統合を有効にします。
セットアップ タブの権限の下に、フルレベルの権限を追加する：
- SOAPウェブサービス
- 会社設定
- トークン・ベースの認証：
[保存]をクリックします。

ステップ 4.統合ユーザーに役割を割り当てる

統合ロールを作成したら、それをコネクターの統合ユーザーに割り当てます：

NetSuite では、セットアップ 、ユーザー/役割 、ユーザー管理 を選択します。
コネクターの統合ユーザーを選択または作成します。

メモ： コネクターまたは統合ごとに個別のユーザーを設定することをお勧めします。
役割で、ユーザーに統合役割を割り当てます。

ステップ5.統合ユーザーのアクセストークンを作成する。

統合ユーザー向けにアクセストークンを作成するには:

NetSuite でセットアップ、ユーザー/役割、使用するアクセストークン、新規を選択します。
新規アクセストークン をクリックする。
アプリケーション名称 で、統合レコードを選択する。
User で、統合ユーザーを選択する。
役割で、統合役割を選択する。
[保存]をクリックします。
トークンに作成された ID とシークレットをメモしてください。これらはコネクターのプロパティに必要です。
メモ： セキュリティのため、IDとシークレットはアクセストークンを作成するときにのみ表示されます。パスワードと同じように扱う。コネクターのプロパティにトークンの ID またはシークレットがない場合は、統合ユーザー用に新規トークンを作成してください。

NetSuite トークン認証コネクターの設定

注：組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成からコネクターを有効にする必要があります。

チェーンビルダー から接続compare_arrows をクリックし、右上の作成をクリックします。
コネクター 接続で、NetSuite トークン認証 とデフォルト CloudRunner を選択します。
接続を識別するための一意の名称と説明を入力します。

[プロパティ]で、接続の詳細を入力します。

プロパティ	詳細
アカウントID	接続するNetSuiteアカウントのIDを入力します。
消費者キー	コネクターの統合レコードの消費者キーを入力します。
消費者の秘密	消費者キープロパティのシークレットを入力する。
トークン ID	コネクターのアクセストークンのIDを入力します。
トークンの秘密	トークン ID プロパティのシークレットを入力します。
サンドボックス	サンドボックス NetSuite アカウントに接続するには、このボックスにチェックを入れます。

注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。

接続を使用する環境を選択して、保存をクリックします。
接続をテストするには、コネクターのList Saves Searchesコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。

トラブルシューティング

カスタムフィールド

NetSuite API はカスタマイズフィールドを返却できませんので、メモしてください。別の方法として、データの準備で、Netsuite カスタムフィールドのロジックを模倣したトランスフォーメーションを作成することができます。

接続

NetSuite への接続に失敗した場合：

コネクターに入力されたアカウントIDを確認します。NetSuite でアカウント ID をビューするには、セットアップ 、統合、ウェブサービス環境設定 を選択します。IDは通常、URLのapp.netsuite.com の直前にも表示されます。
コネクターの統合レコードの消費者キーとシークレットを確認します。必要であれば、統合レコードを編集し、認証情報をリセットして、新規消費者キーとシークレットを作成します。
コネクターのアクセストークンの ID とシークレットを確認します。必要に応じて、コネクター用の新規トークンを作成します。

サポート

コミュニティ

Workiva サポートセンター