モジュールアクセスポリシーデバッガ

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • モジュールアクセスポリシーデバッガを使用してログ記録情報を確認し、ユーザーに暗号化コンテキストへのアクセスが許可される理由と許可されない理由を把握します。

    モジュールアクセスポリシー (MAP) は、暗号化モジュールへのアクセスに対するインスタンスレベルの制御を定義します。問い合わせユーザー (ユーザーやスクリプトなど) は、暗号化と復号化に暗号化モジュールを使用するために明示的なアクセス権を必要とします。問い合わせユーザーが暗号化モジュールにアクセスを試みたときに評価される MAP は明確ではない場合もあります。デバッガを使用して問い合わせユーザーが暗号化モジュールにアクセスを試みたときに評価されるポリシーを確認し、アクセスが付与される理由とされない理由を確認します。

    このフローチャートは、インスタンスが暗号化モジュールへのアクセス要求を評価する方法を示しています。

    暗号化モジュールへのアクセスが評価される方法を示すフローチャート

    デバッグログへのアクセスの制御

    モジュールアクセスのデバッグログへのアクセスは、ロールによって決まります。sn_kmf.admin および sn_kmf.cryptographic_manager ロールを持つユーザーは常にデバッガにアクセスできます。glide.kmf.module_access_policies.debugger.authorized.roles システムプロパティを使用して、他のロールにアクセス権を付与します。このプロパティの値は、デバッグログにアクセスできるロールのカンマ区切りリストです。

    デバッガの有効化または無効化

    モジュールアクセスポリシーのデバッグログメッセージを有効にするには、 すべて > 診断 > セッションのデバッグ > モジュールアクセスポリシーのデバッグ > .

    デバッグが終了したら、次の場所に移動してログ記録メッセージを無効にできます。 すべて > 診断 > セッションのデバッグ > すべて無効化 > .

    ログへのアクセス

    デバッグを有効にした後、MAP 評価をトリガーするページに移動して、MAP デバッグログを表示します。デバッグメッセージがページの下部に表示されます。
    ヒント:
    代理操作を使用して、他のユーザーのアクセスのトラブルシューティングを行うことができます。代理操作の詳細については、「Impersonating users」を参照してください。別のユーザーの観点からデバッグログを表示するには、role タイプのモジュールアクセスポリシーで [代理操作] フィールドが true に設定されていることを確認してください。
    デバッグ出力例

    この例では、問い合わせユーザーが global.fuji 暗号化モジュールへの 2 つのアクセス要求を呼び出します。対称暗号化は許可され、対称復号化は拒否されています。

    ログエントリについて

    デバッグ情報は、この形式を使用して構造化されます。

    1. この最初の行にはアクセス要求を受信する暗号化モジュールが表示されます。
    2. 最初の行と最後の行の間にある行には、評価済みの MAP が評価された順に表示され、名前、タイプ、ターゲット、詳細な操作、および結果が含まれています。
    3. 最後の行には、ポリシー決定 (該当する場合) と問い合わせユーザーの正味アクセス結果 (問い合わせユーザーにアクセス権が付与されているかどうか) が表示されます。

    各行はメッセージタイプを示すアイコンで始まります。

    表 : 1. メッセージアイコン
    アイコン メッセージタイプ
    情報アイコン 情報メッセージ
    MAP のアクセス許可アイコン モジュールアクセスポリシーによりアクセス権が付与される
    MAP のアクセス拒否アイコン モジュールアクセスポリシーによりアクセスが拒否される
    問い合わせユーザーのアクセス許可アイコン 問い合わせユーザーのアクセスが許可される
    問い合わせユーザーのアクセス拒否アイコン 問い合わせユーザーへのアクセスが拒否される
    MAP なしアイコン 評価するモジュールアクセスポリシーなし

    デバッグログの例

    アクセスが許可された場合のメッセージ
    アクセスが許可された場合のデバッグ出力
    アクセスが拒否された場合のメッセージ
    アクセスが拒否された場合のデバッグ出力
    アクセスが拒否されました (評価するモジュールアクセスポリシーなし)
    MAP ポリシーがないためアクセスが拒否された場合のデバッグ出力
    アクセスが拒否されました (十分な権限がない)
    十分な権限がないためアクセスが拒否された場合のデバッグ出力