SAMLアプリの名前IDにカスタム式を使用する

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Zoho DirectoryにあるアプリのSAML SSOを有効化し設定すると、これらのアプリのユーザー認証を手掛けます。この過程で、Zoho Directoryから各アプリに名前 IDという値が伝達されます。この名前 IDは、Zoho Directory内のユーザーIDとアプリ内のユーザーIDを一致させます。

例えば：

Ameliaという名前のユーザーがいて、メールはamelia@zylker.appで、銀行口座番号は123******47だとします。銀行のアプリBankAppにサインインするためにユーザー名として口座番号を入力する必要があるとしましょう。言い換えれば、BankAppは123******47を使用してAmeliaを特定し、amelia@zylker.appは使用しません。

一般的に、SAML SSOがZoho Directoryとアプリの間で設定されると、Zoho Directoryからユーザーのメールアドレスが名前 IDとしてアプリに送信されます。しかし、BankAppでは口座番号が必要で、メールアドレスではないです。amelia@zylker.appが名前 IDとしてBankAppに送信されると、BankAppは口座番号amelia@zylker.appのユーザーを見つけられないというエラーを返します。したがって、SSOを設定する管理者は、Zoho Directoryが口座番号を名前 IDとしてBankAppに送信するように設定しなければなりません。

名前 IDは一意でなければならないため、ほとんどのアプリではユーザーの主メールアドレスを使用します。しかし、他のユーザー情報（名前や姓、あるいはあなたが作成したカスタム項目など）を名前 IDとして指定することも可能です。これは、ユーザー名としてメールアドレスをサポートしていないアプリや、非標準的な認証方法を使用して開発したアプリに役立ちます。

アプリの名前 IDを変更するには：

Zoho Directoryにログインし、左のメニューから管理パネルを選択します。
次にアプリケーションに移動し、名前 IDを変更したいアプリを選択します。
シングルサインオンに移動し、サービスプロバイダー詳細を選択します。
認証詳細の下では、以下を設定できます：

アプリケーションユーザー名：アプリケーションへ送信されるユーザー名となる項目。
名前 ID 形式：ユーザー名を送信する形式。

保存をクリックします。

複雑な要件の場合、アプリケーションユーザー名を複数の項目から成るカスタム式として設定できます。これらの式は、Zoho Directory項目に対する文字列操作メソッドを使用して作成できます。

カスタム式は次のように書かれるべきです：

String_method( , )

たとえば、会社がメールのユーザー名と従業員IDを組み合わせて使用するカスタムアプリを持っているかもしれません。この場合、メールがamelia@zylker.appで、従業員IDが7469のZoho Directoryユーザーは、ユーザー名としてamelia-7469をカスタムアプリケーションで使用します。このシナリオでは、管理者は名前 ID 形式をUnspecifiedに、アプリケーションユーザー名をカスタムに、そしてExpression 値を以下のように設定します：

String.append(String.replace(ユーザー.メール,'@zylker.app','-'),ユーザー.従業員 ID)

この式がどのように動作するかは以下の通りです：

String.置き換えるは最初に実行されます。それにより、ユーザーのメールドメイン（@zylker。app）がハイフンに置き換えられ、amelia@zylker。app がamelia-に変更されます。
String。appendは次に実行され、前の手順で得られた出力に従業員ID（7469）が追加されます。これにより、アプリに送信される最終的なApplication ユーザー名はamelia-7469となります。

以下の表には、これらの表現を作成するために使用できる項目とその対応する形式がリストアップされています：

項目名	形式
名	ユーザー.firstName
姓	ユーザー.lastName
主要メールアドレス	ユーザー.メール
フルネーム	ユーザー.displayName
任意のカスタム項目の情報	ユーザー.<カスタム項目> 例えば、項目名が交通手段番号の場合、形式はユーザー.交通手段番号となります。

表現を作成するために使用できる文字列メソッドは以下の通りです：

文字列メソッド	表現形式	説明	例
追加	String.append(<文字列> , <追加する文字列> )	<追加する文字列> を文字列の <文字列> の末尾に追加します。	String.append(ユーザー.firstName,ユーザー.従業員 ID) ユーザーの'従業員 ID' 項目はユーザーの名前に連結されます。例えば、ユーザー名が'Amelia'で、従業員 IDが'7469'であれば、結果は'Amelia7469'になります。
インデックス	String。indexOf( , )	指定されたキャラクターが初めて出現する位置をこの . で返します。	String。indexOf(ユーザー.firstName,'o') これにより、ユーザーの名前中で文字'o'が初めて出現する位置が返されます。例えば、ユーザーの名前が'Johnson'の場合、最初の'o'の位置は2で、これが返されます。
置換する	String.置き換える( , , )	内のをすべてに置き換えます。	String.置き換える(ユーザー.firstName,'e','a') これにより、'e'のすべてのインスタンスが'a'に置き換えられます。例えば、ユーザーの名前が'Ellen'の場合、名前中のすべての'e'文字が'a'に置き換えられ、結果として' Allan'が得られます。
置き換える First	String。replaceFirst( , , )	これは、の最初のをに置き換えます。	String。replaceFirst(ユーザー.firstName,'e','a') これにより、'e'の最初の例が'a'に置き換えられます。たとえば、ユーザーの名前が'Ellen'の場合、名前の最初の'e'が'a'に置き換えられ、結果として'Allen'になります。
Substring	String。substring( , , )	これにより、インデックスで指定されたの部分が取得されます。	String。substring(ユーザー.firstName,+10、-10,1) これにより、ユーザーの名前から最初と二番目の文字が取得されます。たとえば、ユーザーの名前が'John'の場合、'Jo'という文字列が返されます。
小文字化	String。toLowerCase( )	これは、指定された文字列のすべての文字を小文字に変換します。	String。toLowerCase(ユーザー.firstName) これにより、ユーザーの名前のすべての文字が小文字に変換されます。たとえば、ユーザーの名前が 'John' の場合、'john' が返されます。
大文字化	String。toUpperCase( )	これは、指定された文字列のすべての文字を大文字に変換します。	String。toUpperCase(ユーザー.firstName) これにより、ユーザーの名前のすべての文字が大文字に変換されます。たとえば、ユーザーの名前が 'John' の場合、'JOHN' が返されます。
トリム	String.trim( )	これにより、指定した文字列の先頭と末尾のスペースが削除されます。これは、誤字が含まれている可能性がある項目をサニタイズするため、またはsubstringのような他のメソッドから導出された文字列に使用できます。	String.trim(ユーザー.displayName) これにより、先頭または末尾のスペースが削除されます。たとえば、ユーザーのフル名が ' John Doe' の場合、'John' の前のスペースが削除され、結果として 'John Doe' になります。