Zoho Directory でアプリ用の SAML SSO を有効化して設定すると、Zoho Directory がそれらのアプリへのユーザー認証を行います。認証時に、Zoho Directory はアプリに名前 IDと呼ばれる値を渡します。名前 ID は、Zoho Directory 内のユーザー ID とアプリ内のユーザー ID を対応付けるために使用されます。

例:

ユーザー Amelia のメールアドレスが amelia@zylker.app、銀行口座番号が 123******47 だとします。ある銀行アプリ BankApp では、サインイン時にユーザーがユーザー名として口座番号を入力する必要があるとします。つまり、BankApp は 123******47 を使って Amelia を識別し、amelia@zylker.app は使用しません。

通常、Zoho Directory とアプリ間で SAML SSO を構成すると、Zoho Directory はユーザーのメールアドレスを名前 ID として渡します。しかし、BankApp が期待しているのはメールアドレスではなく口座番号です。もし amelia@zylker.app が名前 ID として BankApp に渡された場合、BankApp は「口座番号が amelia@zylker.app のユーザーが見つからない」というエラーを表示します。そのため、SSO を設定する管理者は、Zoho Directory が口座番号を名前 ID として BankApp に渡すように設定する必要があります。

名前 ID は一意である必要があるため、ほとんどのアプリはユーザーのプライマリメールアドレスを名前 ID として使用します。ただし、名前 ID として他のユーザー情報（名・姓や、作成済みのカスタム項目など）を定義することもできます。これは、アプリがユーザー名としてメールアドレスをサポートしていない場合や、独自開発したアプリで非標準的な認証方式を使用している場合に便利です。

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

より詳細な要件がある場合は、複数の項目を組み合わせて構成したカスタム式として Application ユーザー名を設定できます。これらの式は、Zoho Directory 内のさまざまな項目に対する文字列操作メソッドを使って構成できます。

カスタム式は次の形式で記述する必要があります:

method(<string>,<additional_values>)

例えば、ある組織が、ユーザーのメールユーザー名と従業員 ID の組み合わせをユーザー名として使用するカスタムアプリケーションを持っているとします。Zoho Directory のユーザーのメールアドレスが amelia@zylker.app 、従業員 ID が 7469 の場合、そのカスタムアプリケーションでのユーザー名は amelia-7469 になります。この場合、管理者は 名前 ID 形式 を Unspecified、Application ユーザー名 を カスタム、Expression 値 を次のように設定します:

concat(置き換える(ユーザー。メール,'@zylker。app','-'),ユーザー。従業員 ID)

この式は次のように動作します:

次の表は、これらの式を構成する際に使用できる項目と、その対応フォーマットを示しています。

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

文字列メソッド	式の形式	説明	例
Concat	concat(<string>,<string_to_be_appended>)	<string> の末尾に <string_to_be_appended> を追加します。	concat(ユーザー.firstName, ユーザー.従業員ID) ユーザーの「従業員ID」項目の値の後ろに、ユーザーの名が連結されます。ユーザーの名が「Amelia」、従業員ID が「7469」の場合、値は「Amelia7469」になります。
Index Of	indexOf(<string>,<character>)	<string> 内で、指定した文字が最初に出現する位置を返します。	indexOf(ユーザー.firstName, 'o') ユーザーの名の中で、文字「o」が最初に出現する位置を返します。ユーザーの名が「Johnson」の場合、文字「o」が最初に出現する位置である 1 が返されます。
置き換える	replaceAll(<string>,<string_to_be_removed>,<string_to_be_placed>)	<string> 内にある <string_to_be_removed> のすべての出現箇所を、<string_to_be_placed> に置き換えます。	replaceAll(ユーザー.firstName, 'e', 'a') 文字「e」のすべての出現箇所が「a」に置き換えられます。ユーザーの名が「Ellen」の場合、名前内の文字「e」のすべての出現箇所が「a」に置き換えられ、出力は「 Allan」となります。
置き換える First	replaceFirst(<string>,<string_to_be_removed>,<string_to_be_placed>)	<string> 内にある <string_to_be_removed> の最初の出現箇所を、<string_to_be_placed> に置き換えます。	replaceFirst(ユーザー.firstName, 'e', 'a') 最初に出現する「e」が「a」に置き換えられます。ユーザーの名が「Ellen」の場合、名前内で最初に出現する文字「e」が「a」に置き換えられ、出力は「Allen」となります。
Substring	substring(<string>,<beginIndex>,<endIndex>)	指定したインデックス範囲の <string> の一部を取得します。	substring(ユーザー.firstName, 0, 1) ユーザーの名の 1 文字目と 2 文字目が取得されます。ユーザーの名が「John」の場合、「Jo」という文字列が返されます。
To Lower Case	toLowerCase(<string>)	指定した文字列内のすべての文字を小文字に変換します。	toLowerCase(ユーザー.firstName) ユーザーの名の文字が小文字に変換されます。ユーザーの名が「John」の場合、「john」が返されます。
To Upper Case	toUpperCase(<string>)	指定した文字列内のすべての文字を大文字に変換します。	toUpperCase(ユーザー.firstName) ユーザーの名の文字が大文字に変換されます。ユーザーの名が「John」の場合、「JOHN」が返されます。
Trim	trim(<string>)	指定した文字列の先頭と末尾のスペースを削除します。タイプミスのある項目や、substring など他のメソッドで生成された文字列を整形するために使用できます。	trim(ユーザー.displayName) 余分な空白がある場合は削除されます。たとえば、ユーザーのフルネームが「 Johnson Doe」の場合、「Johnson」の前にあるスペースが削除され、「Johnson Doe」が返されます。