SAML リクエストの署名と暗号化

Documentation Index

Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt

Use this file to discover all available pages before exploring further.

• SAML サービス プロバイダーとしての Auth0（例: SAML 接続）
• SAML アイデンティティ プロバイダー としての Auth0（例: SAML Web App アドオンで構成されたアプリケーション）

1. Auth0 Dashboard > Authentication > Enterprise にアクセスし、SAML を選択します。
2. 表示する接続の名前を選択します。
3. Sign Request を探し、そのスイッチを有効にします。
4. Sign Request スイッチの下にある証明書をダウンロードし、署名を検証できるよう IdP に提供します。

{
	{ 
		"options" : {
			[...], // その他すべての接続オプション
		  "deflate": false
	}
}

openssl req -x509 -nodes -sha256 -days 3650 -newkey rsa:2048 -keyout private_key.key -out certificate.crt

{
	{ 
		"options" : {
			[...], // その他すべてのConnection オプション
		  "signing_key": {
				"key":"-----BEGIN PRIVATE KEY-----\n...{秘密鍵をここに記述}...\n-----END PRIVATE KEY-----",
				"cert":"-----BEGIN CERTIFICATE-----\n...{公開鍵証明書をここに記述}...\n-----END CERTIFICATE-----"
			}
    }
	}
}

1. Auth0 Dashboard > Authentication > Enterprise に移動し、SAML を選択します。
2. 表示する接続の名前を選択します。
3. X509 Signing Certificate を見つけ、証明書をアップロードします。
4. Save Changes を選択します。

• CER
• PEM
• raw PEM
• PKCS#7
• Fingerprint

{
	{ 
		"options" : {
			[...], // その他すべての接続オプション
		  "decryptionKey": {
				"key":"-----BEGIN PRIVATE KEY-----\n...{your private key here}...\n-----END PRIVATE KEY-----",
				"cert":"-----BEGIN CERTIFICATE-----\n...{your public key cert here}...\n-----END CERTIFICATE-----"
			}
	}
}

1. Auth0 Dashboard > Applicationsに移動し、表示するアプリケーションの名前を選択します。
2. ［Settings（設定）］ ページの下までスクロールし、 ［Show Advanced Settings（詳細設定を表示）］ 、 ［Certificates（証明書）］ ビューの順に選択します。
3. ［Download Certificate（証明書のダウンロード）］ を選択し、署名証明書を受け取る形式を選択します。
4. 証明書をサービスプロバイダーに送信します。

1. Auth0 Dashboard > Applicationsに移動し、表示するアプリケーションの名前を選択します。
2. ［Addons（アドオン）］ ビューを選択します。
3. SAML2 Web アプリを選択して設定を表示し、 ［（Settings）設定］ コードブロックを見つけます。
4. "signResponse" キーを見つけます。コメントを解除（または必要に応じて追加）し、値をtrueに設定します（デフォルト値はfalse）。構成はこのようになっているはずです。
   {
     [...], // other settings
     "signResponse": true
   }
   

/**
* Handler that will be called during the execution of a PostLogin flow.
*
* @param {Event} event - Details about the user and the context in which they are logging in.
* @param {PostLoginAPI} api - Interface whose methods can be used to change the behavior of the login.
*/
exports.onExecutePostLogin = async (event, api) => {

    // replace with the ID of the application that has the SAML Web App Addon enabled
      // for which you want to change the signing key pair.
      const samlIdpClientId = 'YOUR_SAML_APP_CLIENT_ID';

    // only do this for the specific client ID.  If you have multiple IdPs that require 
    // custom certificates, you will have an "if" statement for each one.  
    if (event.client.client_id === samlIdpClientId) {

    // ここに独自の秘密鍵と証明書を指定します
    // フォーマット手順については https://auth0.com/docs/authenticate/protocols/saml/saml-sso-integrations/work-with-certificates-and-keys-as-strings を参照してください
    // 基本的にはPEM形式の証明書から始めて、
    // 改行を"\n"に置き換えます
    const signingCert = "-----BEGIN CERTIFICATE-----\nnMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV[..all the other lines..]-----END CERTIFICATE-----\n";
    const signingKey = "-----BEGIN PRIVATE KEY-----\nnMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV[..all the other lines..]-----END PRIVATE KEY-----\n";

    api.samlResponse.setCert(signingCert)    
    api.samlResponse.setKey(signingKey);

  }
  };

1. 公開鍵を使用してサービスプロバイダーの証明書をダウンロードします。
2. Auth0 Dashboard > Applicationsに移動し、表示するアプリケーションの名前を選択します。
3. ［Addons（アドオン）］ ビューを選択します。
4. SAML2 Web アプリを選択して設定を表示し、［（Settings）設定］ コードブロックを見つけます。
5. "signingCert" キーを見つけます。コメントを解除し（または、必要に応じて追加）、その値をサービスプロバイダーからダウンロードした証明書に設定します。構成はこのようになっているはずです。
   {
     [...], // other settings
     "signingCert": "-----BEGIN CERTIFICATE-----\nMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV\n[..all the other lines..]-----END CERTIFICATE-----\n"
   }
   

exports.onExecutePostLogin = async (event, api) => {

// このActionは、Auth0から生成されたSAMLアサーションを暗号化するための特定の公開鍵を設定します
  if (
    event.client.client_id ===
    "THE_CLIENT_ID_OF_THE_APP_WITH_THE_SAML_APP_ADDON"
  ) {
    const encryptionCert =
      "-----BEGIN CERTIFICATE-----\nnMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV[..all the other lines..]-----END CERTIFICATE-----\n";
    const encryptionPublicKey =
      "-----BEGIN PUBLIC KEY-----\nnMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV[..all the other lines..]-----END PUBLIC KEY-----\n";

    api.samlResponse.setEncryptionCert(encryptionCert);
    api.samlResponse.setEncryptionPublicKey(encryptionPublicKey);
  }
};

• AES256 はアサーションの暗号化に使用されます
• RSA-OAEP（MGF1 および SHA1 を含む）は鍵輸送に使用されます

• 証明書とキーを文字列として扱う