公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ IDサービス 外部サービス連携設定例マニュアル

Shopらん

【参考】

2021年07月20日時点での情報で掲載しています。

「Shopらん」との認証連携を設定します。

【注意】

  • ShopらんがSAMLで認証するキーは「ログインID」です。
  • IIJ IDサービス内の各ユーザ共通のユーザ属性にShopらんの「ログインID」と同一の値を保持しておく必要があります。
  • Shopらんの管理者に対してもSAML認証が要求されますので、あらかじめIIJ IDサービス内にShopらんの管理者用アカウントを用意し、Shopらんの管理者用アカウントの「ログインID」をIIJ IDサービス上のアカウントのName IDに指定した属性で登録しておく必要があります。
  • SAML設定後は、IIJ IDで認証が行われます。設定後に、設定の不備などによりShopらんにログインできなくなった場合は、以下のようにURLのクエリに「identity=skip」を加えてアクセスすると、IIJ IDを経由せずにログインできます。
    • https://[ドメイン].jp/h2/Login.do?identity=skip

1. IIJ IDサービスにSAMLアプリケーションを登録する

1. 「アプリケーション」の「アプリケーションの管理」 をクリックします。

2. 「アプリケーションを追加する」をクリックし、「カスタムアプリケーションを追加する」をクリックします。

3. 「SAMLアプリケーション」を選択し、「次に進む」をクリックします。

4. アプリケーション情報を入力し、「アプリケーションを追加する」をクリックします。

項目内容備考
アプリケーション名例）Shopらん必須
アプリケーションの説明例）流通・小売業の本部・店舗間のコミュニケーションに特化したクラウドサービス任意
アプリケーションロゴ（ファイルアップロード）任意
IDプロバイダの選択「アプリケーション専用のエンティティIDを利用」を選択必須
2. IIJ IDサービスのIDプロバイダ情報を確認する

1. 作成されたアプリケーションの「編集する」をクリックします。

2. 「IDプロバイダ情報」をクリックします。

3. 表示された「SSOエンドポイントURL (Redirectバインディング)」、「エンティティID」、及び「PEM」の値を控えます。

【参考】

  • 「PEM」は、必ず「-----BEGIN CERTIFICATE-----」からはじまり「-----END CERTIFICATE-----」で終わる形式です。
  • 「PEM」に書かれている値を改行などせずにそのままファイルに書き出して控えてください。
  • 「PEM」情報は連携先サービスの該当設定画面に貼り付ける必要があります。

3. ShopらんのSAML設定を実施する

1. Shopらんに管理者アカウントでログインします。

2. 「メニュー」の「管理」をクリックします。

3. 「システムの管理」をクリックします。

4. 「オプションの管理」の「セキュリティの設定」をクリックします。

5. 「外部サービスによる本部ユーザ認証」の「SAML2.0で認証する」を選択します。

6. 「外部サービスによる本部ユーザ認証」で以下のとおり入力し、「変更する」をクリックします。

項目内容備考
IdPのエンティティID

手順2-3で控えた「エンティティID」の値


SPのエンティティID（空欄）

ここで値を入力した場合、手順4-4で「エンティティID」にその値を入力してください

ログインポリシー名

「urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified」を選択


SAMLサインオンエンドポイントURL

手順2-3で控えた「SSOエンドポイントURL(Redirectバインディング)」の値


SAMLログアウトエンドポイントURL例）https://www.auth.iij.jp/console/

ログアウト後に表示させたいURLを入力してください

X.509証明書手順2-3で控えた「PEM」の値
4. IIJ IDサービスのSAMLアプリケーションを設定する

1. 「アプリケーション」の「アプリケーションの管理」 をクリックします。

2. アプリケーションの「編集する」をクリックします。

3. 「フェデレーション設定」をクリックします。

4. 以下のとおり設定し、「変更を適用する」をクリックします。

項目内容備考
SAML基本情報





SAML情報を入力する「SAML情報を入力する」をチェック
シングルサインオンURL

https://[ドメイン]/h2/Login.do?func=receiveSamlIdentity

[ドメイン]はお客様環境内で確認してください

エンティティ IDhttps://[ドメイン]/h2

[ドメイン]はお客様環境内で確認してください
※手順3-6で「SPのエンティティID」に値を入力した場合は、その値を入力

NameIDフォーマット

urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified


検証後の遷移先(RelayState)（空欄）
アプリケーションのトップページURL

（空欄）


アサーションの署名アルゴリズム例）
RSA-SHA256
ユーザ識別子(NameID)の指定関連付けるユーザ属性

例）
Entitlements

タイプと一致する値を使用する
タイプ：Shoprun_ID

Shopらんの「ログインID」の値が格納されている属性を指定します

【参考】

「アサーションの署名アルゴリズム」は連携先サービス側で指定などがない場合、デフォルト値の「RSA-SHA256」を選択してください。

「RSA-SHA256」を指定して動作しない場合及び連携先サービス側で明示的にそれ以外のものが指定されている場合は、「RSA-SHA512」、または「RSA-SHA1」に変更し、連携を確認してください。

【参考】

  • 「ユーザ識別子(NameID)」の指定は、ユーザ単位ではなくSAMLアプリケーション単位でのみ設定できます。
  • 「ユーザ識別子(NameID)」の指定した属性にユーザが値を保持していない場合は SAML連携は失敗します。
  • 「ユーザ識別子(NameID)」にID以外の複数の値を持つ属性で指定する方法は以下のとおりです。
    例として、IIJ IDサービスの各ユーザの属性「Entitlements」に以下のように値が設定されています。

    • 連携先サービス側に「ユーザ識別子(NameID)」として渡す値が「iij-jiro@iij.ad.jp」の場合は、「プライマリの値を使用する」をチェックします。
    • 連携先サービス側に「ユーザ識別子(NameID)」として渡す値が「iij-jiro」の場合は、「タイプと一致する値を使用する」をチェックし、タイプに「SaaS_ID」を指定します。

【注意】

  • 「ユーザ識別子(NameID)」としてID以外の属性を指定していると、IIJ IDサービスに対する更新処理でその属性の値が更新される場合があります。ただし、その更新は連携先サービスまで伝搬されないため、IIJ IDサービス側の属性の値が更新されると、連携していたアカウントに接続できなくなります。「ユーザ識別子(NameID)」としている属性の値が更新される場合は、連携先サービス側で紐づく属性（多くの場合、ユーザID）を忘れずに更新してください。
  • 以下の画像のように複数のタイプに「SaaS_ID」が設定されている場合、「ユーザ識別子(NameID)」に「SaaS_ID」を指定すると、サービスマニュアルに記載されているルールに基づいていずれかの単数値だけが採用されます。連携対象のサービスに管理者の意図しないアカウントがSAML連携される危険性があります。対象となる各ユーザにおいて、「ユーザ識別子(NameID)」として指定するタイプが複数個存在しないように注意してください。

5. 「利用者設定」をクリックします。

6. 「利用者を追加する」をクリックし、アプリケーションにシングルサインオンさせたいグループ及びユーザを指定します。

【参考】

利用者に登録していないユーザにもこのアプリケーションを利用させたい場合は、「アプリケーションへのログイン」の「編集」をクリックしします。

「利用者でないユーザも、アプリケーションへのログインを許可する」を選択し、「変更を適用する」をクリックします。