メインコンテンツへスキップ
Deutsch English (United States) Español Français 简体中文 繁體中文

検索

このセクションの記事

PingID SSO を BarTender Cloud と統合する方法

Jarryd Bailey

BarTender Content Team

  • 更新

概要

BarTender Cloudのバージョン11.2アップデート以降、Ping Identity（PingID）SSOを使ってBarTender Cloudにサインインできるようになりました。

この記事では、PingIDアプリケーションとBarTender Cloudテナントを正しく連携させ、スムーズに運用するための設定方法をご案内します。

対象

BarTender Cloud

情報

Ping IDサンプルアプリケーションの作成

まずは、BarTender Cloudと連携するためにPing IDアプリで設定すべきパラメータを説明するため、サンプルアプリを一から作成します。下記の条件が一致していれば、既存のPingIDアプリをBarTender Cloudで利用することも可能です。

  1. お好きなPing ID環境で、左側のApplicationsタブを選択し、+アイコンをクリックして新しいアプリを作成します。

  1. アプリ名を入力します。説明は任意です。OIDC Web Appをアプリケーションタイプに設定し、Saveをクリックします。

  1. 作成したアプリのResourcesタブを選択し、Editアイコンをクリックします。

  1. emailとprofileのチェックボックスをオンにし、Saveをクリックします。これで、openidと合わせて、Allowed Scopesに表示されます。

  1. 次に、Configurationタブを選択し、Editアイコンをクリックします。

  1. ドロップダウンメニューからToken Endpoint Authentication MethodをClient Secret Postに変更します。

  1. Redirect URIを入力します。これは各ユーザーで異なりますが、必ず/signin-callbackで終わります。最初の部分は、ご自身のBarTender Cloudテナントのログインページで確認できます。下記のスクリーンショットの場合、Redirect URIは次のようになります：
https://auth.am1.bartendercloud.com/signin-callback
下記のスクリーンショットは一例です。ご自身のBarTender Cloudログインページで正しいURLを確認してください。例えば、ヨーロッパ拠点のテナントの場合、Redirect URIの最初の部分はhttps://auth.eu1.bartendercloud.comとなります。

  1. Signoff URLを入力します。最初の部分はRedirect URIと同じですが、末尾が/signout-callback-oidcに変わります。上記の例の場合、Signoff URLは次の通りです：
https://auth.am1.bartendercloud.com/signout-callback-oidc
  1. Saveをクリックして設定を完了します。

  1. 最後にアプリを有効化します。どのタブでも画面左上のトグルスイッチをクリックしてください。青色になれば有効化されています。

PingIDユーザーの作成

PingIDを使ってBarTender Cloudに初めてサインインする前に、ログイン用のPingIDユーザープロファイルを作成する必要があります。

  1. 左側のDirectory > Usersに移動し、+アイコンをクリックして新しいユーザーを追加します。

  1. すべての項目を入力し、Saveをクリックします。後でBarTender Cloudにログインする際に使うので、ユーザー名とパスワードは忘れないようにしてください。

BarTender Cloudテナントの設定

PingIDの設定はテナント単位で適用されます。ユーザーごとではありません。PingIDアプリの値が変更されない限り、一度だけ設定すればOKです。

次に、BarTender CloudテナントがPingIDアプリと通信できるように設定します。

  1. BarTender Cloudにログインします。左側のツールバーから管理 > セキュリティ > IDプロバイダーに進みます。
  2. アイデンティティプロバイダーを追加をクリックします。
  3. PingIDを探してセットアップをクリックします。
  4. Client IDとClient Secretの入力が必須であることが分かります。

  1. これらの値はPingIDアプリのOverviewタブにあります。正確にコピーするため、表示されているコピーアイコンの利用を強くおすすめします。

  1. それぞれBarTender Cloudの該当フィールドに貼り付け、左下の接続テストをクリックします。成功したら接続を作成をクリックしてください。
  2. 接続テストが失敗した場合は、Client IDとClient Secretを再度ご確認ください。

これでPingIDがBarTender Cloudテナントと正常に連携されました。

PingIDを使ったBarTender Cloudへのログイン

PingIDとBarTender Cloudテナントの設定が完了したら、実際にログインを試してみましょう。

  1. BarTender Cloudのログインページで、Ping Identityでサインインをクリックします。Ping Identityのログイン画面が表示されます。

  1. 先ほど作成したPingIDユーザーアカウントのユーザー名とパスワードを入力し、Sign Onをクリックします。

  1. 続行する前に、最初に設定したパスワードの変更が必要です。完了したらSaveをクリックしてください。この後の流れは、BarTender Cloudテナントで自動アカウント作成を有効にするがオンかオフかによって異なります。

自動アカウント作成を有効にした場合

自動アカウント作成を有効にしたままの場合、PingIDユーザーアカウントと紐づける新しいBarTender Cloudユーザーアカウントの作成画面に進みます。

  1. 必要事項をすべて入力し、次へをクリックします。

  1. 利用規約に同意し、完了をクリックします。これで、今後このPingID認証情報でBarTender Cloudアカウントにログインできるようになります。

自動アカウント作成を有効にしない場合

自動アカウント作成をオフにした場合、PingID認証情報と紐づけたいBarTender Cloudユーザーアカウントでサインインするよう求められます。

  1. サインインを続行をクリックし、BarTender Cloudの認証情報を入力してサインインをクリックします。これで、今後このPingID認証情報でBarTender Cloudアカウントにログインできるようになります。

トラブルシューティング

この記事で紹介している内容（BarTender CloudやPingIDアプリの設定など）については、BarTenderテクニカルサポートが対応可能です。ただし、PingID自体の障害やサブスクリプションの問題、BarTender Cloudとの連携以外のPingIDの問題についてはサポートできません。その場合はPing Identityサポートまでご連絡ください。

よくあるエラーメッセージが2つあります。まず、PingIDでBarTender Cloudにサインインしようとした際にこのエラーが表示される場合、入力した認証情報が正しくありません。パスワードを忘れた場合は、パスワードをお忘れですかをクリックしてリセットメールを受け取ってください。

次に、以下のエラーはBarTender CloudまたはPingID側の設定ミスや障害など、さまざまな原因が考えられる一般的なエラーです。

すべての設定手順を正しく実施し、BarTender Cloudに正確な値を入力したか再度ご確認ください。

設定に不安がある場合は、テクニカルサポートまでお気軽にご連絡ください。サポートに連絡をクリックしてチケットを作成できます。

追加リソース

BarTenderサポートへのお問い合わせ方法

BarTender Cloudユーザーアカウント管理

関連記事