Domino リソースアダプタは、com.waveset.adapter.DominoResourceAdapter クラスで定義されます。

このアダプタは、次のバージョンの Lotus Domino Server をサポートします。

リソースを設定する際の注意事項

ここでは、Identity Manager で使用する Domino リソースの設定手順を説明します。次のような手順があります。

一般的な設定手順

Domino リソースアダプタを設定するには、次の手順を使用します。

Domino をサポートするようにゲートウェイをインストール

ゲートウェイを Dimino に接続するには、あらかじめインストールされた Notes クライアントを、ゲートウェイマシン上に用意してください。


注	Domino Active Sync アダプタ (com.waveset.adapter.DominoActiveSyncAdapter) は、Identity Manager 5.0 SP1 以後は非推奨になりました。現在、このアダプタのすべての機能は Domino Gateway アダプタに含まれています。Domino Active Sync アダプタの既存のインスタンスは引き続き機能しますが、これらのインスタンスの新しいインスタンスは作成できなくなります。

Windows レジストリの HKEY_LOCAL_MACHINE¥SOFTWARE¥Waveset¥Lighthouse¥Gateway に、次の文字列値を追加して、Domino が正しく動作するようにします。

Identity Manager 上で設定する際の注意事項

このリソースに必要な追加のインストール手順はありません。

使用上の注意

ここでは、Domino リソースアダプタの使用に関する情報を示します。次のトピックで構成されています。

再認証処理

再認証処理は、「recertify」という名前の Boolean 型ユーザー属性を使用して行われます。この属性は更新操作中にチェックされ、有効であれば、ユーザー ID が再認証されます。

再認証処理は adminp 処理によって行われます。つまり、adminp 要求を生成すると、それ以降のいずれかの時点で、その ID の再認証が行われます。再認証のタイミングは、Dimino サーバーの設定に基づいて決まります。5.0 では、アドレス帳のエントリが再認証された場合、ユーザーが次にシステムにログインしたときに、ID ファイルは新しいダイジェストキーで修正されます。

パスワードの変更

管理パスワードを変更したりリセットしたりすることはできません。変更時には現在のパスワードが必要になるので、ユーザーは自分自身のパスワードを変更する必要があります。

現在のパスワードは、スキーママップ内で WS_USER_PASSWORD という名前のアカウント属性として定義され、暗号化型にする必要があります。

有効化と無効化

Domino 6.0 以降でユーザーを無効化する場合は、CheckPassword アカウント属性を 2 に設定することをお勧めします。ただし、5.x で使用した、ユーザーを DENY GROUP に追加する方法もまだ使用できます。

Domino 6.0 より前のバージョンでは、ユーザーごとのネイティブな無効化フラグがないため、無効化された各ユーザーは DENY GROUP 内に配置されます。有効化すると、これらは定義済みグループのいずれかのメンバーとして削除されます。DENY GROUP にはメンバーの最大数のしきい値が設定されているので、グループをリソースに対するアカウント属性として指定してください。このためには、追加の DenyGroups アカウント属性をリソースに渡す必要があります。DenyGroups は、無効化、有効化、またはプロビジョニング解除の実行時に設定できますが、取得するには追加のコーディングが必要です。

プロビジョニング解除または無効化の実行中に、ユーザーを追加する先の DenyGroups のリストを送信します。有効化の実行中には、ユーザーが削除される DenyGroups のリストを送信します。

次のコードによって、使用可能な DenyGroups をリソースから取得できます。


注	Notes クライアントがネットワーク対応のプロファイルとともに実行中であることを確認します。ini ファイルのコピー後にネットワーク接続を変更する場合、再度コピーを行うか、次のようなコマンド行によってクライアントを実行します。 C:¥Lotus¥Notes¥notes.exe=PathToIniFile

<invoke name='listResourceObjects' class='com.waveset.ui.FormUtil'>
   <ref>:display.session</ref>
   <s>DenyLists</s>
   <s>YourResourceName</s>
   <null/>
   <s>false</s>
</invoke>

次のコードによって、現在割り当てられている DenyGroups を、無効化、有効化、またはプロビジョニング解除フォームに取得できます。

<invoke name='getList'>
   <invoke name='getView'>
      <ref>display.session</ref>
      <concat>
         <s>UserViewer:</s>
         <ref>resourceAccounts.id</ref>
      </concat>
      <map>
         <s>TargetResources</s>
         <list>
            <s>YourResourceName</s>
         </list>
      </map>
   </invoke>
   <s>accounts[YourResourceName].DenyGroups</s>
</invoke>

無効化、有効化、またはプロビジョニング解除フォームでは、DenyGroups 属性を次のようにアドレス指定します。

resourceAccounts.currentResourceAccounts [YourResourceName].attributes.DenyGroups

次の例では、複数選択ボックスの左側にある使用可能な DenyGroups を一覧表示する無効化フォームのフィールドを定義しています。

<Field name='resourceAccounts.currentResourceAccounts [YourResourceName].attributes.DenyGroups'>
   <Display class='MultiSelect'>
      <Property name='title' value='Deny Groups'/>
      <Property name='required'>
         <Boolean>false</Boolean>
      </Property>
      <Property name='allowedValues'>
         <invoke name='listResourceObjects' class='com.waveset.ui.FormUtil'>
            <ref>:display.session</ref>
            <s>DenyLists</s>
            <s>YourResourceName</s>
            <null/>
            <s>false</s>
         </invoke>
      </Property>
      <Property name='availableTitle' value='Available Deny Groups'/>
      <Property name='selectedTitle' value='Assigned Deny Groups'/>
   </Display>
</Field>

次の例では、非表示フィールドの取得規則内の割り当てられた DenyGroups を一覧表示する有効化フォームのフィールドを定義しています。

   <Derivation>
      <invoke name='getList'>
         <invoke name='getView'>
            <ref>display.session</ref>
            <concat>
               <s>UserViewer:</s>
               <ref>resourceAccounts.id</ref>
            </concat>
            <map>
               <s>TargetResources</s>
               <list>
                  <s>YourResourceName</s>
               </list>
            </map>
         </invoke>
         <s>accounts[YourResourceName].DenyGroups</s>
      </invoke>
   </Derivation>
</Field>

ID ファイル

ゲートウェイマシンでは、新しく登録されたユーザーに対して新規 ID が生成されます。これらは、ゲートウェイの処理やサービスにアクセス可能な UNC パス上に配置されます。したがって、¥¥machine¥ids¥myidfile.id と指定すると、ネットワーク共有に配置されます。

ユーザーの作成時に指定される共有部分にアクセスするためのサービスとしてゲートウェイを設定した場合、このゲートウェイに対してユーザーとして実行する必要がある可能性があります。共有部分にアクセスできるように SYSTEM を割り当てることもできますが、これはゲートウェイネットワーク環境がどのように見えるかに依存します。

「アドレス帳に ID を保存」リソース属性を TRUE または FALSE に設定することで、ID ファイルをアドレス帳に格納するかどうかを指定することもできます。

Rename/Move

move アクションや rename アクションも、adminp 処理によって実行されます。move は、certifierOrgHierarchy 属性を変更して元の certifierId ファイルとその id ファイルのパスワードを入力することによって、名前変更フォームから開始できます。move 要求によって要求データベース内に「名前移動要求」が作成されます。また、move 要求は、ユーザーの新しい組織を代表する新しい認証者によって完了させます。move は、ユーザーの姓または名を変更することで開始できます。

リソース名

ゲートウェイでは、すべての Domino リソースに一意の名前を付ける必要があります。複数の Identity Manager の配備があり、それらが同じゲートウェイを「指す」場合、それらの配備に存在するすべての Domino リソースには、一意のリソース名を付けてください。

ActiveSync 設定


注	rename と move を同時に実行することはできません。adminp 処理で rename と move の同時実行ができないのは、要求が、どちらの場合にも変更される標準的な名前を参照するためです。

Identity Manager 5.5 より前のバージョンでは、Active Sync の「削除を更新として処理」チェックボックスが選択されている場合、Identity Manager は、削除された Identity Manager ユーザーとすべてのリソースアカウントを無効にし、あとで削除するためにユーザーにマークを付けていました。このチェックボックスは、デフォルトで選択されていました。Identity Manager 5.5 以降では、削除規則セットを「なし」に設定することによってこの機能が設定されます。

チェックボックスの選択が以前に解除されていた場合は、削除規則が「ActiveSync has isDeleted set」に設定されます。

追加情報

ここでは、このアダプタに関して、次のようないくつかの追加情報を提供します。

ListAllObjects

Domino で指定したすべてのオブジェクトを一覧表示できます。listAllObjects 呼び出しへの「タイプ」として渡します。

フォームの更新

これらの操作の一部には追加の属性が必要であるため、それらの属性を含むように、デフォルトのフォームを更新してください。

さまざまなビューに渡される属性は、リソース定義によってあらかじめ定義されています。

searchFilter

次のサンプル UserForm では、getResourceObjects メソッドの searchFilter オプションを Domino 用に実装する方法を示します。このフォームでは、リソース MyResource 上で姓が Smith であるすべてのユーザーを検索しています。

<Form name='Domino searchFilter Form' objectType=UserForm'>
   <Display class='EditForm'/>
   <Field name='rcwfield'>
      <Display class='MultiSelect'>
         <Property name='title' value='My Lister'/>
         <Property name='availableTitle' value='Listing available items'/>
         <Property name='selectedTitle' value='Selected Item(s)'/>
         <Property name='allowedValues'>
            <block trace='true'>
               <invoke name='getResourceObjects' class='com.waveset.ui.FormUtil'>
                  <ref>:display.session</ref>
                  <s>People</s>
                  <s>MyResource</s>
                  <Map>
                     <MapEntry key='searchAttrsToGet'>
                        <List>
                           <String>LastName</String>
                           <String>ShortName</String>
                           <String>MailFile</String>
                        </List>
                     </MapEntry>
                     <MapEntry key='searchFilter' value='@IsAvailable(LastName) & @Contains(@LowerCase(LastName);"smith")'/>
                  </Map>
               </invoke>
            </block>
         </Property>
      </Display>
      <Disable>
         <i>0</i>
      </Disable>
   </Field>
</Form>

その他のフォームに関する問題点

ビューに渡されるように設定する属性

アクション

前アクションと後アクションでは、次の変数を使用できます。

WSUSER_UNID 変数は Lotus Notes の汎用 ID を参照します。この変数は、アカウントが作成されるまで参照できません。

セキュリティーに関する注意事項

ここでは、サポートされる接続と特権の要件について説明します。

サポートされる接続

Identity Manager は、Sun Identity Manager Gateway を使用して Domino と通信します。

必要な管理特権

プロビジョニングに関する注意事項

次の表に、このアダプタのプロビジョニング機能の概要を示します。

アカウント属性

機能	サポート状況
アカウントの有効化/無効化	使用可
アカウントの名前変更	使用可
パススルー認証	使用不可
前アクションと後アクション	使用可
データ読み込みメソッド	リソースからインポート調整 Active Sync

次の表に、Domino のアカウント属性に関する情報を示します。
特に記述がないかぎり、デフォルトのデータ型は String です。


リソースユーザー属性	説明
alternateOrgUnit	代替言語での、ユーザーの組織単位。
AltFullName	ユーザーの母国語での、ユーザーのフルネーム
AltFullNameLanguage	代替のフルネームに使用される言語。
Assistant	補佐の名前。
CalendarDomain	カレンダのドメイン名。
CellPhoneNumber	ユーザーの携帯電話番号。
certifierIDFile	ゲートウェイマシンを基準とした認証者 ID ファイルへのパス (リソースの値をオーバーライドする)
CertifierOrgHierarchy	/US1 など、認証者の組織階層のパス (リソースの値をオーバーライドする)
CheckPassword	Integer。 0 = チェックしません 1 = チェックします 2 = ユーザーを無効にします
Children	従業員の子どもの名前 (複数可)。
City	ユーザーの自宅住所の市。
Comment	ユーザーに関するコメント。
CompanyName	ユーザーが勤務する会社。
Country	ユーザーの自宅住所の国。
credentials	認証者 ID ファイルのパスワード (リソースの値をオーバーライドする)
dbQuotaSizeLimit	ユーザーのメールデータベースの最大サイズを指定します。1000 未満の値を指定した場合、最大サイズの単位はメガバイト (M バイト) になります。1000 以上の値を指定した場合、最大サイズはバイト単位で表されます。1001 ～ 1023 の値は、1024 バイトに切り上げられます。この属性を設定するには、プロキシ管理者がサーバードキュメント内で管理者として一覧表示される必要があります。
dbQuotaWarningThreshold	データベースのサイズについての警告が生成される基準となる、ユーザーのメールデータベースのサイズを指定します。1000 未満の値を指定した場合、しきい値の単位はメガバイト (M バイト) になります。1000 以上の値を指定した場合、しきい値はバイト単位で表されます。1001 ～ 1023 の値は、1024 バイトに切り上げられます。この属性を設定するには、プロキシ管理者がサーバードキュメント内で管理者として一覧表示される必要があります。
defaultPasswordExp	発行 (作成、再認証操作) する新しい証明書に対する日数。
deleteMailFileOption	リソースの属性を次のようにオーバーライドします。 0: メールファイルを削除しません 1: 人物レコードに指定されたメールファイルのみを削除します 2: 人物レコードに指定されたメールファイルとすべての複製を削除します注意: mailfile および adminp を削除するように設定した場合、要求はキューに入れられ、削除する前にネイティブで承認する必要があります。
DenyGroups	リソースへのアクセスを拒否されるユーザーのリスト。
Department	ユーザーの部署名または部署番号。
DisplayName	ユーザーの表示名。
EmployeeID	ユーザーの一意の従業員 ID。
firstname	ユーザーの名。
HomeFAXPhoneNumber	ユーザーの自宅の FAX 番号と電話番号
HTTPPassword	Web ブラウザまたはその他の HTTP クライアントから Notes サーバーにアクセスするときに使用するパスワード。
idFile	ゲートウェイマシンを基準とした ID ファイルへの完全修飾パス。
gateway machine
InternetAddress
JobTitle	ユーザーの役職。
lastModified	ユーザーを最後に変更した日時の文字列表現。
lastname	ユーザーの姓
Location	オフィスの場所またはメールの到着場所
MailAddress	ユーザーの電子メールアドレス。
MailDomain	ユーザーのメールサーバーのドメイン名。
MailFile	メールファイルの名前 (MAIL¥JSMITH など)
mailOwnerAccess	メールボックスの所有者のアクセス制御レベルを示します。取り得る値は、0 (マネージャー)、1 (設計者)、および 2 (エディタ) です。この属性は、デフォルトではスキーママップ内に存在しません。ユーザーの作成時のみに適用できる属性です。
MailServer	ユーザーのメールサーバー名。
MailTemplate	メールテンプレートの名前。作成時のみ有効。
Manager	ユーザーのマネージャー。
MiddleInitial	最後にピリオドの付いたミドルネームのイニシャル。
NetUserName	ユーザーのネットワークアカウント名。
NotesGroups
objectGUID	ユーザーの NotesID。
OfficeCity	ユーザーの勤務先住所の市。
OfficeCountry	ユーザーの勤務先住所の国。
OfficeFAXPhoneNumber	ユーザーの勤務先住所の FAX 番号。
OfficeNumber	ユーザーの勤務先住所の局番号。
OfficePhoneNumber	ユーザーの勤務先住所の電話番号。
OfficeState	ユーザーの勤務先住所の州または都道府県。
OfficeStreetAddress	ユーザーの勤務先住所の街路住所。
OfficeZIP	ユーザーの勤務先住所の郵便番号。
orgUnit
password	ユーザーのパスワード
PasswordChangeInterval	Integer。ユーザーが新しいパスワードを設定する必要が生じるまでの日数。
PasswordGracePeriod	パスワードの期限切れ後にユーザーがロックアウトされるまでの日数。
PhoneNumber	ユーザーの自宅電話番号。
PhoneNumber_6
Profiles
Recertify	Boolean。ユーザーを再認証することを示すフラグ。
SametimeServer	ユーザーの Sametime サーバーの階層名。
ShortName	一般に外国のメールシステムによって使用される短いユーザー名。
Spouse	ユーザーの配偶者の名前。
State	ユーザーの自宅住所中の州または都道府県。
StreetAddress	ユーザーの自宅住所。
Suffix	ユーザーの世代を表す修飾子
Title	ユーザーの資格
WebSite	ユーザーの Web サイト。
WS_USER_PASSWORD	ユーザーのパスワード変更要求時に、ユーザーの現在のパスワードを送信するために使用する属性。
x400Address
Zip	ユーザーの自宅住所の郵便番号。

アイデンティティーテンプレート

Domino では、各ユーザーのアイデンティティーは userid ファイルに格納されます。ただし、それと同じユーザー名が FullName 属性内のユーザーレコードに格納されます。この属性は複数値を取り、リスト内の最初の属性は一意です。リスト内の最初の名前は、標準的な形式で格納され、次のようになります。

この名前を使用して、名前やアドレス帳のレコードを取得できます。Identity Manager では、この文字列は、次に示すような「すっきりとした」形式で resourceInfo に格納されます。

Domino には、API レベルで名前を変換したり戻したりするための組み込みの関数があります。また、Identity Manager も NOTEID を GUID 属性として格納しており、可能な場合は常にこのグローバル識別子を使用して Domino 内のユーザーを検索します。

デフォルトのアイデンティティーテンプレートは次のとおりです。

環境によっては、ミドルネームのイニシャルが含まれない場合もあります。

サンプルフォーム

トラブルシューティング

Identity Manager のデバッグページを使用して、次のクラスにトレースオプションを設定します。

Exchange 5.5

Microsoft Exchange リソースアダプタに対するサポートは非推奨になりました。

Exchange と統合されている、Exchange 2000/2003 の Active Directory リソースを使用してください。

また、次のメソッドに対してトレースを有効にすることで接続の問題について診断できます。

前へ目次索引次へ
Sun Java™ System Identity Manager 7.0 リソースリファレンス