ホスティングされたサインイン・ページの概要
ホスティングされたサインイン・ページでは、スタイル・クラス、カスタムHTMLおよび翻訳サポートを使用して、アイデンティティ・ドメインのサインイン・エクスペリエンスのルック・アンド・フィールをカスタマイズできます。
ホスティングされたサインイン・ページについて学習:
ホスティングされたサインイン・ページを作成します。
ログイン・エクスペリエンスのカスタマイズ
サインイン・ページに独自の背景イメージを追加します。 |
ブランディング設定でサインイン・ページに提供される背景イメージは、すべてのサインイン・フローに適用されます。「サインイン・ページのブランディングのカスタマイズ」を参照してください。 |
ホスティングされたサインインを使用して、カスタムHTMLおよびカスタム翻訳を提供します。 |
ホスティングされたサインインでは、現在のサインイン・ページ定義を上書きするために、カスタムHTMLおよびカスタム翻訳が提供されます。このカスタマイズは、メイン・サインイン・ページに適用されます。すべてのサインイン・フローに影響するわけではありません。たとえば、パスワードのリセットおよびMFAフローには影響しません。 ホスティングされたサインイン・ページ:
ホスティングされたサインイン・ページの作成を参照してください。 |
前提条件
- この機能は、JET 7.2に基づいています。JET 7.2をサポートするすべてのブラウザでこの機能を使用できます。
- 管理者は、サインイン・ページの既存のスタイル・クラスに精通しています。
制限事項
- HTMLコメント(
<!-- comment -->
)は使用できません。 -
カスタムJavaScriptの追加は許可されていません。
-
<style>
タグは使用できません。ただし、インライン・スタイルの要素のみを使用できます(例:<div style="property: value, ...">
) -
コード検証は行われません。「プレビュー」オプションを使用して、カスタム・コードが有効であることを確認します。
-
使用可能なスタイル・プロパティは限られます。
- align-items:
- background-color:
- background:
- border-radius:
- border:
- box-shadow:
- content:
- display:
- height:
- justify-content:
- left:
- margin-top:
- margin:
- max-height:
- max-width:
- min-height:
- padding-left:
- padding-right:
- padding:
- position:
- text-align:
- top:
- width:
-
使用可能なHTMLタグは限られています。
- div
- img
- label
- input
- h1
- h2
- h3
- span
カスタムHTMLの理解
ホスティングされたサインインが初めて有効化されると、デフォルトのHTMLコードが提供されます。このコードをカスタマイズして、ホスティングされたサインイン・ページを定義します。この新しいコードがカスタムHTMLになります。
このデフォルトのHTMLコードをカスタムHTMLのテンプレートとして使用します。コードは完全に機能しており、何も変更されていない場合でもホスティングされたサインイン・ページが使用できることを意味します。
デフォルトのHTML
<!--
NOTE:
Comments on this code are not displayed in the custom HTML area of Hosted Sign-in page,
they are just for documentation purposes
-->
<!-- classes starting with oj-flex are JET util classes for layout -->
<div class="oj-flex oj-sm-flex-direction-column">
<!-- classes named oj-idaas-xxx , like oj-idaas-signin-app-shell or oj-idaas-signin-app-shell-background are the default classes assigned to sign-in page -->
<div id="oj-idaas-signin-app-shell-background" class="oj-idaas-signin-app-shell oj-idaas-signin-app-shell-background">
<div class="oj-flex oj-idaas-signin-app-shell-wrapper oj-idaas-signin-app-shell-wrapper-background">
<div class="oj-flex-item oj-sm-12 oj-idaas-signin-app-shell-padding-left oj-idaas-signin-app-shell-padding-right">
<div class="oj-idaas-signin-app-shell-branding-logo-wrapper">
<!--
This image with id = custom-idaas-signin-branding-logo displays
the sign-in page customer logo or the default logo (if no custom logo is provided)
-->
<img id="custom-idaas-signin-branding-logo" class="oj-idaas-signin-app-shell-branding-logo"/>
</div>
<!-- oj-idaas-signin-section displays the company name and welcome text -->
<oj-idaas-signin-section id="custom-idaas-signin-section"></oj-idaas-signin-section>
</div>
<div class="oj-flex-item oj-sm-12 oj-idaas-signin-app-shell-content-wrapper">
<!-- oj-idaas-signin-message displays the error and warning messages, DO NOT REMOVE this section -->
<oj-idaas-signin-message id="custom-idaas-signin-message"></oj-idaas-signin-message>
<div class="oj-idaas-signin-app-shell-padding-left oj-idaas-signin-app-shell-padding-right">
<!--
DO NOT REMOVE.
oj-bind-slot tag, provides the core functionality of the sign-in page, it is the main widget.
This will generate the area where username and password are entered
-->
<oj-bind-slot name="content"></oj-bind-slot>
</div>
</div>
</div>
</div>
</div>
カスタマイズしたHTMLの例
<!--
NOTE:
In this example two new labels are added by using a div tag. The text in the div tags is dynamically inserted by
providing translations (see translations section below).
-->
<div class="oj-flex oj-sm-flex-direction-column">
<div id="idcs-app-shell-signin-background" class="oj-idaas-signin-app-shell oj-idaas-signin-app-shell-background">
<!-- Example of how the inline style can be applied -->
<div class="oj-flex" style="margin:20px 0;width:520px;min-height:400px;padding:50px 0;position:absolute;top:0px;left:16px;background-color:#ffffff;border-radius:6px">
<div class="oj-flex-item oj-sm-12 oj-idaas-signin-app-shell-padding-left oj-idaas-signin-app-shell-padding-right">
<div class="oj-idaas-signin-app-shell-branding-logo-wrapper">
<!--
These two div tags are new elements (labels) introduced in the page, it is important to assign
a data-idcs-text-translation-id id to each new element introduced, this id will be used to apply the translated text to the element.
If the text doesn't have to be translated, no id is required and you can hardcode the text in the element.
-->
<h2 data-idcs-text-translation-id="welcometext" id="any1"> </h2>
<h3 data-idcs-text-translation-id="welcometext2" id="any3"> </h3>
<img id="custom-idaas-signin-branding-logo" class="oj-idaas-signin-app-shell-branding-logo" />
</div>
<oj-idaas-signin-section id="custom-idaas-signin-section"></oj-idaas-signin-section>
</div>
<div class="oj-flex-item oj-sm-12 oj-idaas-signin-app-shell-content-wrapper">
<oj-idaas-signin-message id="custom-idaas-signin-message"></oj-idaas-signin-message>
<div class="oj-idaas-signin-app-shell-padding-left oj-idaas-signin-app-shell-padding-right">
<oj-bind-slot name="content"></oj-bind-slot>
</div>
</div>
</div>
</div>
</div>
翻訳の仕組みの理解
ホスティングされたサインインを使用すると、既存の要素およびカスタムHTMLコードの新しい要素の翻訳を指定できます。
デフォルトの翻訳値は{}
で、カスタムHTMLコードに翻訳が提供されないことを意味します。
翻訳の構造
data-idcs-text-translation-id
で、値は様々な言語および翻訳された文字列を含むオブジェクトです。次の例には、既存の要素(idcs-username-label
)および新しい要素(welcometext
)の翻訳が含まれています。{
"idcs-username-label": {
"en": "Account ID",
"es": "Cuenta de usuario o correo Electronico"
},
"idcs-username-placeholder": {
"en": "Enter your Account ID",
"es": "Introduzca su nombre de usuario o correo electronico"
},
"idcs-password-label": {
"en": "Pass-word",
"es": "Contra-sena"
},
"idcs-password-placeholder": {
"en": "Enter your password",
"es": "Introduzca su contrasena"
},
"welcometext": {
"en": "Welcome to our Portal",
"es": "Bienvenido"
},
"welcometext2": {
"en": "This is great",
"es": "Bienvenido"
}
}
- 要素:
username label
- 予約ID:
idcs-username-label
- 要素:
username placeholder
(ユーザー名フィールド内のヘルプ・テキスト) - 予約ID:
idcs-username-placeholder
- 要素:
password label
- 予約ID:
idcs-password-label
- 要素:
password placeholder
(ユーザー名フィールド内のヘルプ・テキスト) - 予約ID:
idcs-password-placeholder
新しいラベルの翻訳
「ホスティングされたサインイン」ページで、<div>
、<span>
、または<h1>
、<h2>
、<h3>
などのヘッダー・タグを使用して新しいラベルが導入された場合は、翻訳ID (data-idcs-text-translation-id
)を指定する必要があります。たとえば、要素のdata-idcs-text-translation-id
を使用して翻訳済テキストを提供する場合は、<div data-idcs-text-translation-id="instructions"></div>
を使用します。
バックアップURLを使用したサインイン・ページのリカバリ
ホスティングされたサインイン・コードに加えられた変更によってサインイン・フローが中断された場合(コア・コンポーネントの削除など)、管理者はこのURLを使用してデフォルトのログイン・ページでサインインし、アイデンティティ・ドメインにアクセスできます。
次のようなバックアップURLを作成します: <hostname:[port]>/ui/v1/signin?noBranding=true
これは単なるリカバリ・メカニズムであるため、リカバリ・サインイン・ページにロゴが正しく表示されません。