認証の構成

• Active Directory (NOT Active DirectoryAzure )

• Okta

• ワンログイン

• Keycloak

クイックスタートガイドのない IdPs については、以下のセクションを参照してください。

SAML をアクティブにするには、 IdP で Instana 用の SAML アプリケーションを作成し、個々のユーザに割り当てる必要があります。 SAMLを通じて作成されたユーザーには、デフォルトのロールが自動的に割り当てられます。

サービス・プロバイダー・キーの作成を怠っていたセルフ・ホスト・セットアップは、サービス・プロバイダー・キーを作成し、サービス・プロバイダーを設定する必要があります。 サービス・プロバイダーの設定方法の詳細については、 サービス・プロバイダーの設定を参照してください。

Instana は、次の 2 つの方法で SAML を設定できます。 IdP:

• メタデータファイルの交換による自動コンフィギュレーション
• に必要な値を入力して手動で設定する。 IdP

これらの両方の方法は、Instana の [認証の構成 - SAML] ダイアログで構成できます。

一部の ID プロバイダ（ IdPs ）は、メタデータ・ファイル交換による自動 SAML 構成をサポートしている。 SAML 認証を自動的に構成するには

1. Instana UI のナビゲーションメニューから、 [Settings ] > [ Security & access ] > [ Identity providers ] > [ SAML ] に進みます。
2. 認証の構成 - SAML」ダイアログに、電子メール ID とサービス・プロバイダ（SP）エンティティ ID を入力する。
3. お使いの IdP で Instana メタデータのアップロードが許可されている場合は、 ** Automatic を選択します。
4. Instanaメタデータのダウンロードをクリックする。
5. ダウンロードした Instana メタデータを ID プロバイダにアップロードします。
6. IdP から IdP メタデータをダウンロードする。
7. Instanaにアップロードするファイルを選択] をクリックし、 IdP メタデータをInstanaにアップロードします。
8. 新しいシークレット タブまたは別のブラウザを開き、 IdP 認証情報を使用して Instana へのログインを試み、構成を確認します。

ID プロバイダが Instana メタデータのアップロードを許可していない場合は、手動設定を使用できます。 手動構成の場合は、SAML アプリのメタデータ値を入力する必要がある。 エラーを回避するには、Instana UI の [Configure authentication - SAML] ダイアログから必要な値をコピーして貼り付けます。

SAML 認証を手動で構成するには

1. Instana UI のナビゲーションメニューから、 [Settings ] > [ Security & access ] > [ Identity providers ] > [ SAML ] に進みます。
2. 認証の構成 - SAML」ダイアログに、電子メール ID とサービス・プロバイダ（SP）エンティティ ID を入力する。
3. マニュアルを選択する。
4. IdP, で、Instana UI で提供される値を使用して SAML アプリを作成する。 値の詳細については、 Instana メタデータの値を参照してください、
5. IdP から IdP メタデータをダウンロードする。
6. Instanaにアップロードするファイルを選択] をクリックし、 IdP メタデータをアップロードします。
7. 新しいシークレット タブまたは別のブラウザを開き、 IdP 認証情報を使用して Instana へのログインを試み、構成を確認します。

ユーザー名は、ログイン時にIdPによって提供されるSAML属性から生成されます。

X500-style属性とその既知の別名の一般的な推奨事項に従います。

指定された属性からユーザー名を抽出する際には、以下のロジックが適用されます。

• 属性名 name/displayname/cn/urn:oid:2.5.4.3のいずれかとして表示名が提供されているかどうかを確認してください。
• 属性名 firstname/givenname/gn/userfirstname/urn:oid:2.5.4.42のいずれかとして名が提供されているかどうかを確認してください。
• 属性名 lastname/sn/userlastname/surname/urn:oid:2.5.4.4のいずれかとして姓が提供されているかどうかを確認してください。

表示名は、他のすべてのオプションよりも優先されます。 表示名は見つからないが、名、姓、またはその両方のみが検出された場合は、検出された名前が使用されます。 何も検出されない場合は、NameID (ユーザーメール)の@-signの前のストリングを使用して名前が生成されます。

名前の変更は、IdPとの交換を必要とするため、ユーザーがログアウトした後に反映されます。

SAML 項目をナビゲーション・ペインに表示するには、 core.secret を以下のように構成する：

1. keyPassword として mykeypass と入力する。

    # SAML configuration
    serviceProviderConfig:
    # Password for the key/cert file
    keyPassword: mykeypass
    

2. 以下のコマンドを実行してキーを作成する：

   openssl genrsa -aes128 -out key.pem 2048
    

3. 以下のコマンドを実行して証明書を作成する：

   openssl req -new -x509 -key key.pem -out cert.pem -days 365
    

4. 以下のコマンドを実行して、鍵と証明書を1つのファイルにまとめる：

   cat key.pem cert.pem > sp.pem
    

設定フォームを見つけるには、Instana UI のナビゲーションメニューから、 [設定 ] > [ セキュリティとアクセス ] > [ Identity Providers ] をクリックします。

IdPサイド・アプリケーションのサービス・プロバイダーとしてInstanaを構成します。 IdPの以下の値が必要です。

• ClientID:これは、IDプロバイダーによってアプリケーションに割り当てられたIDです。

• クライアント秘密鍵:これは、アイデンティティー・プロバイダーからの応答の真正性を検証するためにInstanaによって使用されるトークンです。 この値は秘密鍵であり、安全に保管されます。

• ディスカバリー URL : OIDC 設定のディスカバリー URL を使用すると、Instana が自動的にそれを取得します。

• 管理者/所有者アカウント: OIDCアカウントのメール・アドレスをここに入力する必要があります。 OIDC フローへの切り替え後、このアカウントに最初に owner 権限が付与され、他のすべてには default 権限が割り当てられます。

さらに、Idp 側の構成には次の値が重要です。

• リダイレクトURL: IdPで設定したリダイレクトURIによって、応答がInstanaに送信される場所が決まります。
• セッション終了URL/サインアウトURL: IdP開始ログアウトの場合。