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

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

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

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を変更するには:
  1. Zoho Directory にサインインし、左側のメニューから管理者パネルをクリックします。
  2. アプリケーションへ移動し、名前IDを変更したいアプリをクリックします。
  3. シングルサインオンへ進み、サービスプロバイダー詳細をクリックします。
  4. 認証情報の詳細で、以下の設定が可能です:
    1. アプリケーションユーザー名:アプリにユーザー名として渡す項目を指定します。
    2. 名前ID形式:ユーザー名を渡す形式を指定します。
  5. 保存をクリックします。
詳細な要件に応じて、アプリケーションユーザー名を複数の項目を組み合わせて構成したカスタム式として設定することもできます。これらの式は、Zoho Directory内のさまざまな項目で文字列操作メソッドを使用して作成できます。

カスタム式は次の形式で記述します:
method( , )



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

この式がどのように動作するかを以下に説明します:
  1. 置き換えるが最初に実行されます。これは、ユーザーのメールドメイン(@zylker.app)をハイフンに置き換え、amelia@zylker.app amelia-に変換します。
  2. appendが次に実行され、前の手順で得られた出力(amelia-)の末尾に従業員ID(7469)を追加します。したがって、アプリに渡される最終的なApplication ユーザー名 amelia-7469となります。
次の表は、これらの式を作成する際に使用できる項目と、それぞれのフォーマットを示しています。

項目 名前
形式

ユーザー.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」が返されます。


    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



            Zoho Campaigns Resources

              Zoho WorkDrive Resources




                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day


                • Ask the Experts









                                Resources

                                Videos

                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                eBooks

                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                Webinars

                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                CRM Tips

                                Make the most of Zoho CRM with these useful tips.