テーマの管理

テーマは、テナント上のアプリケーション＝アクセスをブランド化するために使用されます。テーマにより、ユーザーは IBM® Verifyによって表示されるページのルック・アンド・フィールをカスタマイズできます。

このタスクについて

重要:

管理テーマへのアクセスを制限するには、管理者の役割と権限機能を使用します。テーマ開発者ロールと manageThemes の権限へのアクセスを制限する。カスタマイズされたHTMLには、インライン JavaScript。ファイルをアップロードする前にHTMLコンテンツをサニタイズするか、カスタムコンテンツセキュリティポリシーを設定してインラインスクリプトが実行されないようにします。

IBM Verifyでアプリケーションを構成するときに、ブランドがログイン・ページに表示されるようにテーマを適用できます。テーマ内のファイルのグループは必要に応じて更新できます。テーマはテナントに固有です。

ほとんどのテーマ・ファイルには、コンテキスト情報を使用して変更できるマクロが含まれています。マクロとは、実行時にデータがレンダリングされる @ 記号間の文字です。形式の例:

@ACTION@

マクロはテーマ・ファイル内に保持してください。ただし、ページのその他のフォーマット設定や通知は、ニーズに応じて変更できます。

注: テーマ・ファイルの最大ファイル・サイズは 100 KB です。

テーマ・ファイルは、次の形式の圧縮ファイルを使用してダウンロードおよびアップロードできます。

/templates/
           {templateDirectories}/
                  	{locales}/
                               {templateNames}

注: 以下のディレクトリーの下にあるページは、デフォルト・テーマでのみサポートされます。デフォルト・テーマ内のページは、アプリケーションに固有ではありません。これらは、 Verify テナントのすべてのアプリケーションに適用されます。

templates/notifications/access_applications_request
templates/notifications/user_management/admin
templates/notifications/user_management/legacy_deprecated
templates/notifications/user_management/login/user_password_expired_email.xml
templates/notifications/user_management/login/user_password_expiring_email.xml

テーマを作成したら、そのテーマをアプリケーションに適用します。これを行うには、アプリケーションの設定で「テーマ」フィールドを設定します。詳細については、「アプリケーションの基本詳細の設定」を参照してください。

手順

テーマを操作するには、アクセス・トークンを要求します。

manageTemplates資格を持つ API クライアントを使用して、アクセス・トークンを生成します。詳細については、 APIクライアントの作成を参照してください。

Request:

curl https://<tenant-hostname>/oidc/endpoint/default/token 
-d "grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>"
Response:
{
"access_token":"m1KhswVeQy84CF4sAki88phTkpmnYtaDzWi26ASX",
"grant_id":"079ffb03-61ed-44fe-b42f-cb6f51c8c169",
"token_type":"Bearer",
"expires_in":7200
}

以降の要求のために、アクセス・トークンを保管します。

次の手順

Verify テナントのブランディングを続けるには、以下の関連タスクのいずれかを選択します。