Zoho DirectoryでアプリのSAML SSOを有効にし、設定すると、Zoho Directoryがユーザーをそれらのアプリに認証します。認証時、Zoho Directoryは名前IDという値をアプリに渡します。名前IDは、Zoho Directory内のユーザーとアプリ内のユーザーの識別情報を一致させる役割を果たします。

例：

ユーザーのAmeliaが、メールアドレスamelia@zylker.appと銀行口座番号123******47を持っているとします。たとえば、銀行アプリのBankAppでは、サインイン時にユーザーが口座番号をユーザー名として入力する必要があります。つまり、BankAppではAmeliaの識別に123******47が使われ、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を変更するには：

詳細な要件に応じて、アプリケーションユーザー名を複数の項目を組み合わせて構成したカスタム式として設定することもできます。これらの式は、Zoho Directory内のさまざまな項目で文字列操作メソッドを使用して作成できます。

カスタム式は次の形式で記述します：

method( , )

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

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

この式がどのように動作するかを以下に説明します：

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

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

文字列メソッド	式形式	説明	例
Concat	concat( , )	を の末尾に追加します。	concat(ユーザー.firstName,ユーザー.従業員 ID) ユーザーの「従業員 ID」項目の値に、ユーザーの名が追加されます。たとえば、ユーザーの名が「Amelia」、従業員 ID が「7469」の場合、値は「Amelia7469」になります。
Index Of	indexOf( , )	指定した文字が 内で最初に現れる位置を返します。	indexOf(ユーザー.firstName,'o') ユーザーの名の中で文字 'o' が最初に現れる位置を返します。たとえば、ユーザーの名が 'Johnson' の場合、'o' が初めて現れる位置は 1 となります。
置き換える	replaceAll( , , )	内の のすべての出現箇所を に置き換えます。	replaceAll(ユーザー.firstName,'e','a') 'e' のすべての出現箇所が 'a' に置き換えられます。たとえば、ユーザーの名が 'Ellen' の場合、'e' のすべてが 'a' に置き換えられ、結果は 'Allan' となります。
First を置き換え	replaceFirst( , , )	内で、 の最初の出現箇所を に置き換えます。	replaceFirst(ユーザー.firstName,'e','a') 'e' の最初の出現箇所が 'a' に置き換わります。たとえば、ユーザーの名が 'Ellen' の場合、名前内の最初の 'e' が 'a' に置き換わり、出力は 'Allen' となります。
サブストリング	substring( , , )	指定したインデックスにより、 の一部を取得します。	substring(ユーザー.firstName,0,1) ユーザーの名から最初と2番目の文字が取得されます。たとえば、名が 'John' の場合、文字列 'Jo' が返されます。
小文字に変換	toLowerCase( )	指定した文字列内のすべての文字を小文字に変換します。	toLowerCase(ユーザー.firstName) ユーザーの名の文字がすべて小文字に変換されます。たとえば、ユーザーの名が「John」の場合、「john」が返されます。
大文字に変換	toUpperCase( )	指定した文字列内のすべての文字を大文字に変換します。	toUpperCase(ユーザー.firstName) ユーザーの名の文字がすべて大文字に変換されます。たとえば、ユーザーの名が「John」の場合、「JOHN」が返されます。
Trim	trim( )	指定した文字列の先頭および末尾のスペースを削除します。typoの可能性がある項目や、substringなど他の方法で生成された文字列のクリーンアップにも使用できます。	trim(ユーザー.displayName) 空白が存在する場合、その空白が削除されます。例えば、ユーザーのフル名前が「 Johnson Doe」の場合、「Johnson」の前にあるスペースが削除され、「Johnson Doe」が返されます。