Swipeguide:シングルサインオン(SSO)
Last updated: June 19, 2026
一般的な使用
当社はプラットフォーム向けにOAuth2認証統合を提供しており、Web CMS、Webフロントラインアプリ、オフラインアクセス用のSwipeGuideネイティブアプリ(iOSおよびAndroid)、およびスマートスキルアプリへのログインに使用できます。
これにより、ユーザーはお客様の会社が管理するOAuth2プロバイダーを通じて認証できます。
ユーザーフレンドリーで分かりやすいシステムを維持するため、プラットフォーム内の認証レベルは引き続きプラットフォーム内で管理されることにご注意ください。
ワークスペースのニーズに応じて、CMSおよびフロントラインアプリで、メールアドレスとパスワード、SSOなど、異なる種類のログイン方法を設定できます。または、ユーザーにSSOのみでログインするよう求めることもできます。
プラットフォームでこの機能を有効にする場合は、このドキュメントを使用する前に必ずSwipeGuideサポートにお問い合わせください。
前提条件
- プラットフォームでログインオプションがすでに有効になっている必要があります(公開プラットフォームではない場合)。
- SwipeGuideへのサインインに使用するOAuth2プロバイダーは、有効な認証情報または証明書を使用して、ITチームによってすでに管理・セットアップされている必要があります。SwipeGuideは、システム内のアプリケーションの1つとしてすでに追加されている必要があります。
OAuth2 セットアップ
基本的なドキュメントについては、OAuthのウェブサイトを参照してください。プラットフォームをセットアップするには、OAuth2認証サービスに提出する必要がある情報と、サービスを接続するために必要な情報があります。OAuth2認証サービス内でセットアップする必要があるコールバックURLがあり、サービスからOAuth2認証トークンを取得する必要があります。これらはサービスごとに異なります。
現在、標準で以下をサポートしています:
- Microsoft Entra ID(旧称 Azure AD)
Microsoft Entra ID
Microsoft Entra ID(旧称 Azure AD)のセットアップを機能させるには、以下が必要です: clientID、 clientSecret、 resource および tenantです。これらについては、Azure Entra ID の OAuth ドキュメントをご確認ください。
コールバック URL
https://[platform].swipeguide.com/sso/azureadoauth2/callback
URL 内の platform は、参照する必要があるプラットフォームのメインドメインです。このコールバック URL は単一ドメインとマルチドメインの両方のプラットフォームで機能し、ユーザーは適切にリダイレクトされます。
Google
Google のセットアップを機能させるには、clientID、clientSecret、hostedDomain が必要です。これらについては、Google の OAuth ドキュメントをご確認ください。
コールバック URL
https://[platform].swipeguide.com/sso/googleoauth2/callback
URL 内の platform は、参照する必要があるプラットフォームのメインドメインです。このコールバック URL は単一ドメインとマルチドメインの両方のプラットフォームで機能し、ユーザーは適切にリダイレクトされます。
SAML 2.0 セットアップ
SAML セットアップを機能させるには、メタデータファイルまたは以下の情報が必要です:
entryPoint: SSO サービス URL cert: 使用する場合、受信する SAML 応答の署名を検証するために使用される公開署名証明書。
送信していただく必要があるクレーム: displayName, ID, Email
アサーションコンシューマーサービス URL
https://[platform].swipeguide.com/sso/saml/consume
SAML メタデータ
https://[platform].swipeguide.com/sso/saml/metadata
エンティティ ID: swipe-guide
URL 内のプラットフォームは、参照する必要があるプラットフォームのメインドメインです。このコールバック URL はシングルドメインとマルチドメインの両方のプラットフォームで機能し、それに応じてユーザーがリダイレクトされることにご注意ください。
セッションの自動タイムアウト
追加のプラットフォームサービスおよび設定として、リクエストがない状態(サーバーへのリクエストがない状態)が X 分間続いた後にセッションを自動的にタイムアウトさせるよう、カスタマーサクセスマネージャーを通じて依頼できます。
よくある質問
1. SwipeGuide へのログイン後に SSO 認証エラーが表示された場合の対処方法
シークレットキーの有効期限が切れているため、SwipeGuide プラットフォームへのログイン時に認証エラーが表示される場合があります。
シングルサインオン(SSO)は、1 組の認証情報だけを使用して、ユーザーが複数のアプリケーションやウェブサイトに安全に認証できる認証方式です。
現在、SSOはアドオン機能であり、サポートにチケットを提出することでリクエストできます。これをセットアップするには、御社のIT部門が、希望するソリューションプロバイダーに基づいた必要な情報をSwipeGuideのエンジニアリングチームに提供する必要があります。お客様のキーの管理や保守は、当社では一切行っておりません。
秘密鍵の有効期限が切れた、または切れそうだと思われる場合は、以下を行ってください:
- このことを各拠点のIT部門に知らせ、新しい証明書を事前に依頼する
- 新しい詳細情報をSwipeGuideサポートに連絡する
注:ユーザーがログインできなくなることを防ぐため、御社で2年ごとにリマインダーを設定し、新しい認証情報を当社に共有することを強くお勧めします。
2. 共有デバイス上の複数ユーザー
たとえば、「オペレーターAとオペレーターBが共有デバイスを使用しており、オペレーターAがAPPからログアウトした後、オペレーターBがAPPにログインする」という状況に遭遇することがあります。このとき、オペレーターBにはオペレーターAのスキルマトリックスが表示されます。
なぜこのようなことが起こるのでしょうか?
ユーザーがSSOを使用してアプリにログインすると、そのデバイス上にすでにアクティブなSSOセッションがあるかどうかが確認されます。オペレーターAがアプリからサインアウトしても、SSOアカウント自体から完全にサインアウトしていない場合、次のユーザー(オペレーターB)はSSOでログインした際に、自動的にオペレーターAとして認識されます。これは、SSOや類似のサービスを使用する多くのアプリで一般的な動作です。ブラウザまたはデバイスの現在のサインイン状態に依存しているためです。
共有デバイスを使用する際に、各ユーザーが認証情報を入力する必要があるようにするには、次の手順に従ってください。
1. アプリの使用後、通常どおりAPPからログアウトします。
2. ブラウザまたはデバイス上のSSOアカウント(例:Google)からも完全にサインアウトします。
3. 次のユーザーは、自分の認証情報でログインできます。
または、このようなSSOによる自動認識を避けるため、共有デバイスではSSOではなくメールアドレスとパスワードを使用してログインできます。