インストール後のカスタマイズ
インストール後、Oracle Universal Authenticatorクライアント・アプリケーションをいつでもカスタマイズするには、REST APIを使用します。
カスタマイズを実行する前に、管理者は次の点に注意する必要があります。
- 「カスタマイズ可能なアイテム」から、必要なプロパティの任意の組合せをカスタマイズできます。
- これはカスタマイズされておらず、フィールド、ラベル、テキストおよびエラー・メッセージのすべてのデフォルト値は、Microsoft Windowsデスクトップで使用される言語で表示されます。カスタマイズを選択した場合、異なる言語に対して任意の数のテーマを作成できますが、カスタマイズされたテキストは自動的に翻訳されないため、カスタマイズするプロパティの値は必要な言語で記述する必要があります。サポートされている言語の詳細は、「カスタマイズ可能なアイテム」を参照してください。
- ロゴをカスタマイズする場合は、ビットマップ形式(BMP)のみで、寸法は192x192である必要があります。それ以外の形式や寸法はサポートされていません。BMPファイルを使用する前に、Microsoft Paintでファイルを開き、正しい形式でファイルを保存することをお薦めします。
- 「インストール中のカスタマイズ」に従ってインストール中にクライアント・アプリケーションをカスタマイズした場合は、インストール後にREST APIを使用して変更を加えることができます。
OAA-Device Runtime Support Service REST APIでは、
<DRSS>/v1/themes/{locale}エンドポイントに対して次の操作を実行できます。
PUT: 特定の言語用にカスタマイズされたプロパティを使用してテーマを作成または更新します。GET: 作成されたテーマを取得するか、特定の言語テーマ用にカスタマイズされたプロパティを取得します。DELETE: 特定の言語用のテーマを削除します。
テーマをOracle Universal Authenticatorクライアント・アプリケーションで使用するには、テーマをアクティブ化する必要があります。これを実行するには、
<DRSS>/oaa-drss/oua/property/v1エンドポイントを使用して、oua.themes.custom.distributionプロパティを1に設定します。このプロパティを0に設定すると、いつでもテーマを非アクティブ化できます。ただし、管理者は次の点に注意する必要があります。
oua.themes.custom.distributionのデフォルト値は0です。つまり、デフォルトではテーマは配信されません。oua.themes.custom.distributionが1の場合、クライアント・アプリケーションがサーバーに対して更新をチェックすると、テーマはOracle Universal Authenticatorクライアント・アプリケーションに配信されます。oua.themes.custom.distributionが1から0に変更された場合、Oracle Universal Authenticatorクライアント・アプリケーションは最後に配信されたテーマを引き続き使用します。即時利用可能なデフォルト値には戻りません。- テーマが削除され、
oua.themes.custom.distributionが1の場合、Oracle Universal Authenticatorクライアント・アプリケーションは、テーマが削除される前に使用していたテーマを引き続き使用します。Oracle Universal Authenticatorクライアント・アプリケーションを即時利用可能なデフォルト値に戻す場合は、削除されたテーマをダミー値で更新する必要があります。 - テーマが
"status": 0で更新され、oua.themes.custom.distributionが1の場合、Oracle Universal Authenticatorクライアント・アプリケーションは即時利用可能なデフォルト値に戻ります。
カスタマイズに使用されるREST APIの詳細は、OAA-Device Runtime Support Service REST APIに関する項を参照してください。
次のチュートリアルでは、OAA-Device Runtime Support Service REST APIを使用したOracle Universal Authenticatorクライアント・アプリケーションのカスタマイズに関して詳しく説明しています。