テーマの管理

テーマは、テナント内のアプリケーションにブランドイメージを反映させるために使用されます。 IBM® Verifyテーマを使用することで、ユーザーは表示されるページの見た目を自分好みにカスタマイズできます。

このタスクについて

重要:

管理者ロールと権限機能を使用して、テーマの管理へのアクセスを制限します。「テーマ開発者」ロールおよびその manageThemes 権限へのアクセスを制限します。カスタマイズされたHTMLには、インラインの JavaScript が含まれる場合があります。ファイルをアップロードする前にHTMLコンテンツをサニタイズするか、インラインスクリプトの実行を防ぐためにカスタムContent Security Policyを設定してください。

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 テナントのブランディングを続けるには、以下の関連タスクのいずれかを選択します。