ヘルプセンター
何かお手伝いできることはありますか?

Microsoft Entraでのシングルサインオン

設定方法

デクセコでは、Microsoft EntraによるSAML認証を使用したシングルサインオンを使用できます。

使用には以下の設定が必要です。

  • Microsoft EntraでSAMLを使用したシングルサインオンアプリの作成
  • デクセコの組織設定 > SSO設定にて下記を設定
    • Entity ID
    • Target URL
    • IdP Certificate

事前準備

事前に、デクセコ側で準備が必要です。

Settings > 組織設定 > SSO設定タブ > シングルサインオンにある「シングルサインオンを有効にする」にチェックを入れます。

Entity IDなどの項目が出ましたら準備完了です。

このあと、Entity IDやTargetURLへの値の入力、またこちらの画面に表示される値のEntra側への入力を行いますのでこの画面は開いた状態のままにしてください。

デクセコ「SSO設定」
デクセコ「SSO設定」

Entra側の設定

1️⃣ Microsoft Entraへのログイン

Microsoft Entraへログインし、Entra管理センターを開きます

 

2️⃣ アプリケーション作成画面を開く

左側メニューから「エンタープライズアプリケーション」を開き、「新しいアプリケーション」を開きます。

Entra「新しいアプリケーションの作成」
Entra「新しいアプリケーションの作成」
 

3️⃣独自のアプリケーションを作成する

「Microsoft Entra ギャラリーを参照する」という画面が開きます。

「独自のアプリケーションの作成」というボタン押すと、右側に同名のモーダルが表示されます。

任意のアプリ名(例:dxeco-saml)を入力「ギャラリーに見つからないその他のアプリケーションを統合します (ギャラリー以外)」を選択し、下部の「作成」ボタンを押します。

Entra「独自のアプリケーションの作成」
Entra「独自のアプリケーションの作成」
 

4️⃣ SAMLの設定をする

アプリケーションのメニューから「シングルサインオン」を選択し、表示された画面から「SAML」をクリックします

Entra「シングルサインオンの設定」
Entra「シングルサインオンの設定」

「SAMLによるシングルサインオンのセットアップ」ページから、基本的なSAML構成の「編集」をクリックします。

Entra「SAMLによるシングルサインオンのセットアップ」
Entra「SAMLによるシングルサインオンのセットアップ」

右側にモーダル「基本的なSAML構成」が表示されます。

「識別子(エンティティID)」にはデクセコの「Issuer」を入力してください

「応答URL(Assertion Consumer Service URL)」にはデクセコの「Assertion Consumer Service URL」を入力してください

💡

入力欄がない場合があります

その際は「識別子の追加」「応答URLの追加」ボタンを押してください

Entra「基本的なSAML構成」
Entra「基本的なSAML構成」
 
デクセコ「Issuer」「Assersion Consumer Service URL」
デクセコ「Issuer」「Assersion Consumer Service URL」

必要に応じて、「属性とクレーム」の内容を更新してください。

💡

「一意のユーザーID」を変更しますとユーザーの判別に使用する値が変わります

Entra「属性とクレーム」
Entra「属性とクレーム」
 

最後に、デクセコへのSAML認証を許可するユーザーの設定や必要に応じてグループの設定などを行ってください。

 

次にデクセコ側の設定を行っていきますが、

Entraの「SAML によるシングル サインオンのセットアップ」画面の値をデクセコに登録していきますので、引き続きそちらの画面は閲覧できるようにしてください。

 

デクセコ側の設定

1️⃣ Microsoft EntraのSAML証明書をデクセコに登録する

まず、Entra「SAMLによるシングルサインオンのセットアップ」画面の「SAML証明書」から、証明書(Base64)をダウンロードし、証明書の内容をデクセコの「IdP Certificate」に貼り付けます。

💡

ダウンロードした証明書はメモ帳等で開き、テキストをコピー&ペーストしてください

Entra SAMLによるシングルサインオンのセットアップ「SAML証明書」
Entra SAMLによるシングルサインオンのセットアップ「SAML証明書」
デクセコ組織設定「IdP Certificate」
デクセコ組織設定「IdP Certificate」
 

2️⃣ 「Microsoft Entra 識別子」をデクセコの「Entity ID」に設定する

次にEntra「(アプリケーション名)のセットアップ」から「Microsoft Entra 識別子」をコピーし、デクセコの「Entity ID」にペーストします。

Entra 「Microsoft Entra 識別子」
Entra 「Microsoft Entra 識別子」
デクセコ「Entity ID」
デクセコ「Entity ID」

3️⃣ アプリケーションの「ユーザーのアクセスURL」をデクセコの「TargetURL」に入力する

作成したアプリケーションのメニューの「プロパティ」をクリックします。

「ユーザー」のアクセスURLという項目があるので、そちらをコピーしデクセコ側の「TargetURL」に入力してください。

Entra「ユーザーのアクセスURL」
Entra「ユーザーのアクセスURL」
デクセコ側「TargetURL」
デクセコ側「TargetURL」
 

4️⃣ 設定を保存する

上記の設定が終了したら、SSO設定下部の「保存」ボタンを押してください

デクセコへのログインの仕方

下記の2つの方法でログインできます

  • Microsoftアカウントのアプリダッシュボード(https://myapps.microsoft.com/)に表示された先ほどのシングルサインオンアプリケーションをクリック
  • デクセコのSSO設定の「ログインID」に記載されているURLにアクセス
デクセコ「ログインID」
デクセコ「ログインID」
 
⚠️
※通常のデクセコのログイン画面 (https://app.dxeco.io) からはシングルサインオンによるログインはできませんので、ご了承ください
 
 

トラブルシューティング

認証後にデクセコの画面に遷移した後「500 Internal Server Error」となる

デクセコにご入力いただいた証明書情報(IdP Certificate)の値や形式が異なっている可能性があります。改めて、以下のいずれかをお試しください

  • Microsoft Entraの証明書(Base64)の値をご入力いただく
  • Microsoft Entraの「フェデレーションメタデータXML」をダウンロードし、XMLタグ「X509Certificate」の値(<X509Certificate>{こちらの値}</X509Certificate>)をご入力いただく
Notion image
 
解決しましたか?
😞
😐
🤩