DSN の作成
このセクションでは、DSN 設定の編集方法と、Marketo API への認証および接続について説明します。
DSN 設定
Microsoft ODBC データソースアドミニストレーターを使ってDSN 設定を編集できます。インストールプロセスではコネクタのインストール で説明のとおり、ユーザーDSN とシステムDSN の両方が作成されることに注意してください。
Note: 本製品 は、接続情報をWindows レジストリに保存します。本製品 がレジストリに書き込めるようにするには、Power BI を管理者として実行するか、接続にシステムDSN ではなくユーザーDSN を使用します。
ユーザーDSN
DSN 設定を編集するには、次の手順を実行してください。
- スタート -> 検索 を選択し、検索ボックスにODBC データソース と入力します。
- Power BI Desktop インストールのビット数(32-bit または64-bit)に対応するODBC アドミニストレーターのバージョンを選択してください。
- システムデータソースを選択して構成をクリックします。
- 接続タブの情報を編集してOK をクリックします。
システムDSN
システムDSN をユーザーDSN と同じ方法で設定します。ただし、ステップ3を実行する前に、システムDSN タブに切り替える必要があります。
Power BI のOn-Premises Data Gateway をStandard モードで使用している場合、システムDSN を使用する必要があります。
OAuthSettingsLocation(OAuth のプロンプトが繰り返されるのを避けるため、OAuth 認証情報をローカルに保存するパス)にも有効な場所を指定する必要があります。
これは、Standard モードがサービスモードで動作し、C:\Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway のような許可された場所にしかアクセスできないためです。
Marketo への接続
Marketo は2つのAPI を提供しています。REST およびSOAP です。使用するAPI を指定するには、 Schema プロパティをREST またはSOAP のいずれかに設定します。
REST API
REST API は、OAuth 認証を使用してユーザーのアクセスを検証します。REST API 経由の Marketo へのアクセスを設定するには:- カスタムサービスを作成します。
- 適切なOAuth 認証情報を取得します。
- 接続変数を設定します。
カスタムサービスの作成
この手順では、REST API 権限を持つ新しいロールを作成し、そのロールを既存または新規のユーザーに割り当て、新しいサービスを作成します。これは管理者権限を持つユーザーによって実行される必要があります。- Marketo アプリケーションの[管理]エリアに移動します。
- [セキュリティ]セクションに移動します。
- ユーザ& ロールをクリックします。
- API アクセス用の新しいロールを作成します。
- ロールタブを選択します。
- 新規ロールをクリックします。
- [ロール名]を指定し、ロールの権限を選択します。REST API に固有の[API へのアクセス]権限を指定します。
- API アクセスを実行するユーザーを割り当てるか、新規作成します。
- ユーザタブを選択します。
- 作成したロールを新規ユーザーに割り当てるには、新規ユーザの招待をクリックします。
- 新しいユーザーの情報を入力し、先ほど作成した、REST API に接続可能なロールを割り当てます。API 専用ユーザーとして指定するには、API のみオプションを選択します。
- 新しいサービスを作成します。
- 管理 -> 統合に移動して、LaunchPoint オプションをクリックします。
- 新規サービスをクリックします。
- サービスタイプをカスタムに指定します。
- サービスの[表示名]および[詳細]を入力します。
- 作成したユーザーをサービスに割り当てます。
Marketo は、Marketo への接続および認証ために設計された新しいREST API サービスを作成します。 また、REST API へのユーザーのアクセスを検証するために必要なOAuth ベースの認証情報も生成します。
OAuth 資格情報を取得
新しいサービスのOAuth 資格情報を取得して記録するには、Marketo [管理]エリアに戻り、 LaunchPoint オプションに移動します。
作成したサービスの詳細の表示リンクをクリックします。Marketo は、認証資格情報を表示するウィンドウを開きます。 これらの資格情報は、OAuthClientId およびOAuthClientSecret の値を提示します。
接続変数の設定
以下の接続変数を設定したら、REST API 経由での接続準備は完了です。- Schema:REST。
- OAuthClientId:カスタムサービスに紐付けられたOAuth クライアントID。
- OAuthClientSecret:カスタムサービスに紐付けられたOAuth クライアントシークレット。
- RESTEndpoint:管理エリアにある、REST Web サービスエンドポイントのURL。 REST API の統合 -> ウェブ サービスセクションに移動して、このURL を見つけます。 Identity Endpoint は空白のままにします。
SOAP API
以下の接続変数を設定したら、SOAP API 経由での接続準備は完了です。- Schema:SOAP。
- UserId:Marketo の[管理]SOAP API パネルの統合セクションにあるクライアントアクセスID。
- EncryptionKey:Marketo Web サイトの[管理]ページで生成される、Marketo SOAP API 暗号化キー。
- SOAPEndpoint:Marketo Web サイトの[管理]ページにある、SOAP Web サービスエンドポイントのURL。