コンテンツへスキップ
Clevera ヘルプセンター

OktaでのSSO設定

Cleveraのシングルサインオン(SSO)をSAML 2.0またはOpenID ConnectでOktaを使って設定する手順です。Oktaアプリの設定、Cleveraの各フィールドへの値の入力、ユーザーの割り当て、テスト方法について説明します。

更新日: 読了時間 3 分

OktaとClevera間でシングルサインオンを設定し、チームメンバーがOktaアカウントでサインインできるようにします。SAML 2.0またはOpenID Connect (OIDC) で接続可能です。このガイドでは、Okta側での設定とClevera側の対応するフィールドについて順を追って説明します。

Oktaの管理コンソールは随時変更されます。以下のラベルが実際の画面と一致しない場合は、同じ意味を持つ設定項目を探してください。値の全リストについては、SAML および OIDC の一般ガイドを参照してください。

始める前に

  • あなたはカスタムプランを利用しているCleveraワークスペースのオーナーであること。
  • アプリ統合の作成と割り当てが可能なOkta管理者であること。
  • メンバーがOktaで使用しているメールドメイン(例: acme.example)を把握していること。

まずCleveraの設定ダイアログを開き、値をコピーできるようにします。サイドバー上部のワークスペースメニューを開き、チーム設定、セキュリティの順に選択して、SSOを設定をクリックします。IDプロバイダーとしてOktaを選択してください。

OktaとSAML 2.0を選択し、コピー対象のエンティティID、ACS URL、メタデータURLが表示されているSSO設定ダイアログのステップ1
これら3つの値をIDプロバイダーに入力してください。

SAML 2.0で接続する

  1. Oktaでアプリを作成する

    Okta管理コンソールで、**Applications(アプリケーション) → Applications(アプリケーション)**に移動し、Create App Integration(アプリ統合を作成)をクリックします。SAML 2.0を選択して次へをクリックします。名前を Clevera に設定し、次へをクリックします。

  2. Cleveraの値を入力する

    **SAML Settings(SAML設定)**で、以下を入力します。

    Oktaフィールド Cleveraからの値
    Single sign-on URL ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback。Use this for Recipient URL and Destination URL にチェックを入れたままにします。
    Audience URI (SP Entity ID) Entity ID / Audience URI (Cleveraダイアログからコピーします。ワークスペースIDで終わります)
    Default RelayState 空のままにします
    Name ID format EmailAddress
    Application username Email
  3. 署名の確認

    Show Advanced Settings(詳細設定を表示)をクリックし、ResponseとAssertion Signatureの両方がSigned(署名済み)になっていること、Signature AlgorithmがRSA-SHA256であること、Assertion Encryptionが**Unencrypted(暗号化なし)**であることを確認します。Cleveraでは、レスポンスとアサーションの両方に署名が必要です。

  4. 名前属性を追加する

    **Attribute Statements(属性ステートメント)**で、値 user.firstName を持つ firstName と、値 user.lastName を持つ lastName を追加します。Cleveraはこれらを使用して新しいアカウントに名前を付けます。次へをクリックし、Oktaのフィードバック質問に内部アプリとして回答して、**Finish(完了)**をクリックします。

  5. Oktaの値をCleveraに入力する

    アプリのSign On(サインオン)タブで、SAML設定の詳細(View SAML setup instructions(SAML設定手順を表示)、または新しいコンソールの場合はMore details(詳細))を開きます。CleveraでプロトコルをSAML 2.0に設定し、続行をクリックして以下を貼り付けます。

    Oktaの値 Cleveraフィールド
    Identity Provider Issuer (または Issuer) IdP Entity ID
    Identity Provider Single Sign-On URL (または Sign on URL) SSOサインインURL
    X.509 Certificate (または Signing Certificate) X.509証明書

    Oktaのシングルログアウトを使用しない限り、ログアウトURLは空のままにします。

    IdP Entity ID、サインインURL、証明書が入力されたSSO設定ダイアログのステップ2
    ログアウトURLは任意です。
  6. ユーザーを割り当てる

    アプリの**Assignments(割り当て)**タブで、**Assign(割り当て)**をクリックし、Cleveraを使用するユーザーまたはグループを追加します。割り当てられていないユーザーはOkta経由でサインインできません。

次にClevera側で完了させます:ドメインとロール。

OpenID Connectで接続する

  1. Oktaでアプリを作成する

    **Applications(アプリケーション) → Applications(アプリケーション) → Create App Integration(アプリ統合を作成)**に移動します。OIDC - OpenID Connectを選択し、Web Application(Webアプリケーション)を選択して次へをクリックします。

  2. リダイレクトURIを設定する

    Cleveraの設定ダイアログで、プロトコルをOpenID Connectに設定し、グレーのボックスから**リダイレクトURI (コールバックURL)**をコピーします。次にOktaで以下を入力します。

    Oktaフィールド 値
    App integration name Clevera
    Grant type Authorization Code
    Sign-in redirect URIs リダイレクトURI (コールバックURL): https://app.clevera.ai/sso/oidc/callback
    Sign-out redirect URIs 例を削除し、空のままにします
    Controlled access アプリを使用できるユーザーを選択するか、**Skip group assignment for now(今はグループ割り当てをスキップ)**を選択して後で割り当てます

    保存をクリックします。

  3. 認証情報をコピーする

    アプリのGeneral(一般)タブのClient Credentials(クライアント認証情報)で、Client IDとClient secretをコピーします。Client authenticationはClient secretのままにします。

  4. Cleveraに入力する

    Cleveraで続行をクリックし、以下を入力します。

    Cleveraフィールド 値
    Client ID Oktaの Client ID
    Client secret Oktaの Client secret
    Discovery URL https:// あなたのOktaドメイン /.well-known/openid-configuration (例: https://acme.okta.com/.well-known/openid-configuration)

    カスタム認証サーバーを使用している場合は、そのDiscovery URL(例: https://acme.okta.com/oauth2/default/.well-known/openid-configuration)を代わりに使用してください。

    クライアントID、シークレット、Discovery URLが入力されたOpenID Connect用SSO設定ダイアログのステップ2
    Discovery URLを使用すると、エンドポイントフィールドは非表示になります。
  5. ユーザーを割り当てる

    **Assignments(割り当て)**タブで、Cleveraを使用するユーザーまたはグループを割り当てます。

Cleveraで完了する

  1. ドメインとロールで、Oktaユーザーが持つすべてのメールドメインを追加し、初回サインイン時にアカウントを作成と新しいSSOメンバーのデフォルトロールを選択します。
  2. 確認で、設定を保存をクリックします。
  3. テストを実行をクリックし、SSOを有効化をオンにして、プライベートウィンドウで割り当てられたテストユーザーとしてCleveraのサインインページからサインインします。
  4. 全員で動作することを確認したら、SSOのみを許可したい場合はSSOを必須にするをオンにします。

メンバーはCleveraのサインインページで仕事用のメールアドレスを入力し、Oktaで続行をクリックします。

トラブルシューティング

問題 確認事項
SAMLでOktaサインイン直後に「SSO認証に失敗しました…」と表示される ResponseとAssertion Signatureの両方が**Signed(署名済み)**であること。Cleveraの証明書がアプリの現在の署名証明書であること。Audience URIがCleveraのEntity IDと完全に一致していること。
OktaでCleveraタイルをクリックした後に「SSOセッションの有効期限が切れました」と表示される 仕様です。サインインはCleveraのサインインページから開始する必要があります。
Oktaでユーザーがアプリに割り当てられていないと表示される アプリの**Assignments(割り当て)**タブでユーザーを割り当ててください。
「あなたのメールドメインはこのチームのSSOで許可されていません。」 ユーザーのOktaメールアドレスが許可されたメールドメインに含まれていません。Cleveraで追加してください。
OktaでリダイレクトURIエラーが表示される (OIDC) Sign-in redirect URIsがCleveraのリダイレクトURI (コールバックURL) (https://app.clevera.ai/sso/oidc/callback) と完全に一致している必要があります。

その他のメッセージ:SSOサインインの問題を修正する。