接続の確立

Sync App アプリケーションの接続ページに移動し、接続の追加 パネルで対応するアイコンを選択して、LDAP への接続を作成します。LDAP アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからLDAP コネクタをダウンロードおよびインストールします。

必須プロパティは［設定］タブにリストされています。［Advanced］タブには、通常は必要ない接続プロパティが表示されます。

LDAP への接続

CData driver for LDAP は、LDAP サーバーオブジェクトへの接続をサポートします。接続するには必要なプロパティを設定します。

必須プロパティ

Server：LDAP サーバーのドメイン名、もしくはIP。
Port：The port setting defaults to port=389.Specifying the port to a different setting is optional.
BaseDN：このプロパティは、結果を指定されたサブツリーに限定するために使用されます。BaseDN（Base Distinguished Name）の範囲を絞ることはパフォーマンスを劇的に向上させます。例えば、cn=users,dc=domain の値は、cn=users およびその子に含まれる結果のみを返します。

オプションのプロパティ

Optional properties can be used to further refine control of the returned results.

FollowReferrals：This property follows referrals when TRUE.The returned response then becomes read only.To modify data returned by a referral server, open a new connection to the server by specifying server and port.
Scope：This property enables more control over the search depth of the LDAP tree, starting with BaseDN.範囲を限定することで、検索パフォーマンスを大幅に向上させられます。Scope を次の値のいずれかに指定します：
- WholeSubtree：検索の範囲を、BaseDN およびすべての子階層に制限します。
- SingleLevel：検索の範囲を、BaseDN および1つ下の子階層に制限します。
- BaseObject：検索の範囲を、ベースオブジェクトのみに制限します。
LDAPVersion：サーバーに接続し、通信する際に使われるLDAP バージョン。2 に設定します。

LDAP への認証

リクエストを認証するには、User およびPassword プロパティを有効なLDAP クレデンシャルに設定します。例えば、User をDomain\\BobF またはcn=Bob F,ou=Employees,dc=Domain に設定します。

The AuthMechanism properties for the Sync App are as follows:

SIMPLE：The default plaintext value of the authentication mechanism to login to the server.
DIGESTMD5：Authenticates to the LDAP server using DIGESTMD5 authentication.
NEGOTIATE：Negotiates whether to use NTLN or Kerberos when authenticating to the server.

SSL Configuration

By default, the driver uses plaintext when communicating with the server set to port=389. The driver automatically switches to use SSL when talking to the LDAP on port=636. You can force the connection to use the SSL connection property when set to SSL=TRUE.

テーブルのカスタマイズ

Sync App は、LDAP エンティティから最も頻繁に必要とされるカラムを表示します。ただし、その他のデータを使用する必要がある場合は、テーブルを簡単に変更できます。テーブルは、シンプルな形式のスキーマファイルで定義されます。

デフォルトのスキーマを拡張する方法や独自のスキーマを記述する方法については、LDAP テーブルとの連携を参照してください。カスタムスキーマを使用するには、Location プロパティをスキーマファイルを有するフォルダに設定します。テーブルおよびビューについて詳しくは、サンプルデータモデルを参照してください。

LDAP テーブルとの連携

LDAP オブジェクトクラスへのテーブルスキーマのマッピングを定義する。

このセクションでは、Person.rsd ファイルを使ってCData Sync App において希望するオブジェクトクラスの新テーブルを作成する方法を説明します。Person.rsd は、Sync App のインストールフォルダのdb サブフォルダに格納されています。

カスタムスキーマを使用するには、Location プロパティをスキーマファイルを有するフォルダに設定します。スキーマを.rsd ファイルで定義する。

新しいテーブルを定義する

新しいテーブルを、そのテーブルが表すオブジェクトクラスと同じ名前に定義することは大切です。これにより、Sync App はLDAP サーバーをクエリする際に、ターゲットのオブジェクトクラスのみを検索します。

rsb:info エレメントでテーブル名を定義する。次の例では、Person.rsd のテーブル名およびカラムの定義について説明します：

<rsb:script xmlns:rsb="http://www.rssbus.com/ns/rsbscript/2">

  <rsb:info title="Person" description="Create, update, delete, and query person entries in LDAP.">
    <!-- Required Columns -->
    <attr name="Id"              xs:type="string"  readonly="true"  key="true"       desc="The index of the row, when 'splitDataByRow' is set for a column, combined with the full distinguished name." />
    ...

テーブルカラムおよびインプット

スキーマ内の"attr" タグは、テーブルのカラムを表します。これらは、希望するオブジェクトクラスを構成するアトリビュートに合致するはずです。

まず、オブジェクトクラスに関係なく、すべてのテーブルに含まれるカラムがあります：

    <!-- Required Columns -->
    <attr name="Id"          xs:type="string" readonly="true"  key="true"       desc="The index of the row, when 'splitDataByRow' is set for a column, combined with the full distinguished name." />
    <attr name="DN"          xs:type="string" readonly="true"  required="false" other:ldaptype="OID"               desc="The full distinguished name." />
    <attr name="RDN"         xs:type="string" readonly="true"  required="false" other:ldaptype="Directory String"  desc="The relative distinguished name."/>
    <attr name="BaseDN"      xs:type="string" readonly="true"  required="false" other:ldaptype="OID"               desc="The base distinguished name." />

必須カラムに加えて、希望するオブジェクトクラスからのアトリビュートが指定される必要があります。追加で、データがテーブルからどのように返されるかを規定するdataFormat を指定する必要があります。次に例を示します。

    <!-- Person Required Attributes -->
    <attr name="ObjectClass"                 other:dataFormat="splitDataByRow" xs:type="string" readonly="false" required="false"  other:ldaptype="OID" desc="The object class of the entry."/>
    <attr name="SN"                          other:dataFormat="delimitedData"  xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The required attribute SN for the user object class."/>
    <attr name="CN"                          other:dataFormat="delimitedData"  xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The required attribute CN for the user object class."/>

    <!-- Person Optional Attributes -->
    <attr name="UserPassword"                other:dataFormat="delimitedData"  xs:type="string" readonly="false" required="false"  other:ldaptype="Binary"                     desc="The optional attribute UserPassword for the user object class."/>
    <attr name="TelephoneNumber"             other:dataFormat="delimitedData"  xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The optional attribute TelephoneNumber for the user object class."/>
    <attr name="SeeAlso"                     other:dataFormat="delimitedData"  xs:type="string" readonly="false" required="false"  other:ldaptype="DN"                         desc="The optional attribute SeeAlso for the user object class."/>
    <attr name="Description_1"               other:dataFormat="splitDataByCol" xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The optional attribute Description for the user object class."/>
    <attr name="Description_2"               other:dataFormat="splitDataByCol" xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The optional attribute Description for the user object class."/>
    <attr name="Description_3"               other:dataFormat="splitDataByCol" xs:type="string" readonly="false" required="false"  other:ldaptype="Directory String"           desc="The optional attribute Description for the user object class."/>

The other: dataFormat には3つのオプションがあります：


delimitedData	Table Setting にて定義された"区切り" により区切られた文字列として、複数のアトリビュートを返します。（デフォルトはセミコロンです。）
splitDataByRow	同じDN に対する複数のアトリビュート値は、別々の行として扱われます。他のすべてのカラムはそのままプッシュされ、Id のインデックスは増分されます。（このように複数のカラムをプッシュすることは、結果セットを大きくしてパフォーマンスの問題を引き起こす可能性があります。）
splitDataByCol	同じDN に対する複数のアトリビュート値は、カラム名の付属インデックスとともにプッシュされます。複数のカラムを定義して終わりに"_n" を付ける必要があります。例えば、ObjectClass_1、ObjectClass_2、ObjectClass_3 のようにします。このサンプルでは、3つを超える値がある場合、カラムが追加されない限り、テーブルでは残りの値は表示されません。

例えば、次のコードはObjectClass アトリビュートの異なる値をそれぞれの行に分割して、Description をそれぞれのカラムにします。カラム定義には、Description アトリビュートの複数のカラムが含まれることに注意してください。<attr> に対する、other dataFormat アトリビュートにも注意してください。

    ...
    <attr name="ObjectClass"     other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="OID" desc="The object class of the entry."/>
    <attr name="SN"              other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The surname of the person."/> 
    <attr name="CN"              other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The common name of the person."/> 
    <attr name="UserPassword"    other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Binary"                     desc="The user password of the person."/>
    <attr name="TelephoneNumber" other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The telephone number of the person."/>
    <attr name="SeeAlso"         other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="DN"                         desc="The see-also distinguished name of the person."/>
    <attr name="Description_1"   other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The description of the person."/>
    <attr name="Description_2"   other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The description of the person."/>
    <attr name="Description_3"   other:dataFormat="delimitedData" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"           desc="The description of the person."/>
    
  </rsb:info>
  
  <!-- Table Settings -->
  <rsb:set attr="delimiter" value=";"/>
  ...

サンプルの結果はこのようになります：


Id	DN	ObjectClass	SN	CN	UserPassword	TelephoneNumber	SeeAlso	Description_1	Description_2	Description_3
1\|CN=User1,DC=Test	CN=User1,DC=Test	Top	TestSN	User1		555-5555	A;B;C	Desc1	Desc2	Desc3
2\|CN=User1,DC=Test	CN=User1,DC=Test	User	TestSN	User1		555-5555	A;B;C	Desc1	Desc2	Desc3

Note：デフォルトで、データはdelimitedData として返されます。

インプットのデータ形式に加え、エンコードも指定が可能です。現在、UTF8 エンコード、もしくはBASE64 エンコードでのデータの戻りがサポートされています。特定のエンコードでデータを取得したい場合には、'other:encoding' フィールドを、使いたいエンコードのアトリビュートに指定する必要があります。エンコードの指定がない場合、UTF8 がデフォルトです。

アトリビュートのエンコード指定の例：

    ...
    <attr name="ObjectClass"     other:dataFormat="delimitedData" other:encoding="UTF8"   xs:type="string"  readonly="false" required="false" other:ldaptype="OID"               desc="The object class of the entry."/>
    <attr name="SN"              other:dataFormat="delimitedData" other:encoding="BASE64" xs:type="string"  readonly="false" required="false" other:ldaptype="Directory String"  desc="The surname of the person."/> 
    ...

テーブル設定

アトリビュートおよびインプットに加えて、区切り記号を指定する必要があります。

区切り記号（Delimiter）は、区切りデータで使われる文字です。区切りデータは、一つのオブジェクトに複数回出現するアトリビュートすべてにおいて返されます（他のdataFormat に指定されている場合を除いて）。

例えば、下のコードは';' 記号を使って、アトリビュートの複数の値をコンカテネイトします。

    ...
  </rsb:info>  
    
  <!-- Table Settings -->
  <rsb:set attr="delimiter" value=";"/>
  ...

オペレーション定義

オペレーション定義は、すべての新たに作られたテーブルにおいてそのまま維持されます。既存テーブルからコピー＆ペーストしてください。

  <!-- Operation definitions -->
  <rsb:script method="GET">
    <rsb:set attr="action" value="Get" />
    <rsb:call op="ldapadoLDAP" >
      <rsb:push />
    </rsb:call>
  </rsb:script>

  <rsb:script method="POST">
    <rsb:set attr="action" value="Post" />
    <rsb:call op="ldapadoLDAP" >
      <rsb:push item="toout"/>
    </rsb:call>
  </rsb:script>

  <rsb:script method="MERGE">
    <rsb:set attr="action" value="Merge" />
    <rsb:call op="ldapadoLDAP" >
      <rsb:push />
    </rsb:call>
  </rsb:script>

  <rsb:script method="DELETE">
    <rsb:set attr="action" value="Delete" />
    <rsb:call op="ldapadoLDAP" >
      <rsb:push />
    </rsb:call>
  </rsb:script>

高度な機能

このセクションでは、LDAP Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App を使用すると、事前設定されたクエリによって内容が決定されるユーザー定義ビューと呼ばれる仮想テーブルを定義できます。このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。カスタムビューの作成と設定の概要については、ユーザー定義ビューを参照してください。

SSL の設定

SSL の設定を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、接続文字列オプションにあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシを含むファイアウォールとプロキシに合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、LDAP にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくはクエリ処理を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログを参照してください。基本的なロギングでは、次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、より洗練されたロギングをサポートする多数の機能があります。

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。

別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

次のプロパティを設定します。

プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
接続をトンネルするには、FirewallType をTUNNEL に設定します。
認証するには、FirewallUser とFirewallPassword を設定します。
SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

サンプルデータモデル

CData Sync App は、LDAP エンティティをリレーショナルテーブルおよびストアドプロシージャにモデル化します。

テーブル

The included テーブル cover many standard LDAP object classes. You can easily extend the table schemas to map more closely to your LDAP classes. The schemas are defined in simple configuration files. The schemas shipped with the Sync App are located in the db subfolder of the installation directory.

See LDAP テーブルとの連携 for a guide to customizing table schemas.

To use custom tables and schemas, set the Location property to the folder containing the schema files.

ストアドプロシージャ

ストアドプロシージャは、データソースのファンクションライクなインターフェースです。これらは、 SELECT、INSERT、UPDATE、またはDELETE として表されていないLDAP 機能にアクセスするために使用できます。

テーブル

Sync App はLDAP のデータを、標準のSQL ステートメントを使用してクエリできるテーブルのリストにモデル化します。

一般的には、LDAP テーブルのクエリは、リレーショナルデータベースのテーブルのクエリと同じです。時には特別なケースもあります。例えば、テーブルの特定のカラムデータを取得するために特定のカラムをWHERE 句に含める必要がある場合などです。これは通常、特定のカラムを取得するために行ごとに個別のリクエストを行う必要がある場合に必要です。これらの特別な状況は、以下にリンクされているテーブルページの上部に明確に文書化されています。

LDAP Connector for CData Sync テーブル


Name	Description
Group	Stores a list of user names. Used to apply security principals on resources.
OrganizationalPerson	This class is used for objects that contain organizational information about a user, such as the employee number, department, manager, title, office address, and so on.
Person	Contains personal information about a user.
Top	The top level class from which all classes are derived.
User	This class is used to store information about an employee or contractor who works for an organization. It is also possible to apply this class to long term visitors.

Group

Stores a list of user names. Used to apply security principals on resources.

テーブル固有の情報

Select

すべてのカラムは、演算子=、>=、<=、!=、LIKE、AND、およびOR のサーバー側の処理をサポートします。その他のフィルタはSync App 内でクライアント側で実行されます。例えば、次のクエリはLDAP によって処理されます。

SELECT * FROM Group WHERE  GroupType != '-2147483644' AND  ObjectClass = 'top;group' LIMIT 5

SupportEnhancedSQL をfalse に設定すると、クライアント側の実行をオフにできます。その場合、その他の演算子を参照する検索条件でエラーが発生します。

Insert

Group を追加するには、Id、DN、およびBaseDN 以外のすべてのフィールドを指定できます。必須のフィールドはRDN とObjectClass です。次に例を示します。

INSERT INTO Group (RDN, ObjectClass) VALUES ('CN=Domain Admins', 'group')

Update

Id、DN、およびBaseDN 以外のすべてのカラムは、WHERE 句にId を指定することで更新できます。次に例を示します。

UPDATE Group SET Member = 'CN=SUPPORT_388945a0,CN=Users,DC=MyDC' WHERE Id = '1|CN=HelpServicesGroup,CN=Users,DC=MyDC'

Delete

DELETE ステートメントにGroup のId を指定することで、グループを削除できます。次に例を示します。

 DELETE FROM Group WHERE Id = '1|CN=HelpServicesGroup,CN=Users,DC=MyDC'

Columns


Name	Type	ReadOnly	References	DataFormat	Description
Id [KEY]	String	True			Combined index and DN. Multiple indices are only possible when a column is set to SplitDataByRow.
DN	String	True			The full distinguished name.
RDN	String	False			The relative distinguished name.
BaseDN	String	True			The base distinguished name.
GroupType	String	False		DelimitedData	Contains a set of flags that define the type and scope of a group object. For the possible values for this attribute, see Remarks.
ObjectClass	String	False		SplitDataByRow	The list of classes from which this class is derived.
Member	String	False		DelimitedData	The list of users that belong to the group.
NTGroupMembers	String	False		DelimitedData	This attribute is not used.
OperatorCount	String	False		DelimitedData	Operator count.
AdminCount	String	False		DelimitedData	Indicates that a given object has had its ACLs changed to a more secure value by the system because it was a member of one of the administrative groups (directly or transitively).
GroupAttributes	String	False		DelimitedData	The Group-Attributes attribute is not currently used.
GroupMembershipSAM	String	False		DelimitedData	WindowsﾂNT Security. Down level WindowsﾂNT support.
ControlAccessRights	String	False		DelimitedData	Used by DS Security to determine which users can perform specific operations on the host object.
DesktopProfile	String	False		DelimitedData	The location of the desktop profile for a user or group of users. Not used.
NonSecurityMember	String	False		DelimitedData	Nonsecurity members of a group. Used for Exchange distribution lists.
ManagedBy	String	False		DelimitedData	The distinguished name of the user that is assigned to manage this object.
PrimaryGroupToken	String	False		DelimitedData	A computed attribute that is used in retrieving the membership list of a group, such as Domain Users. The complete membership of such groups is not stored explicitly for scaling reasons.
Mail	String	False		DelimitedData	The list of email addresses for a contact.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Filter	String	Defines the LDAP filter explicitly, overriding any other values set in the WHERE clause.

OrganizationalPerson

This class is used for objects that contain organizational information about a user, such as the employee number, department, manager, title, office address, and so on.

Table Specific Information

Select

All columns support operators =, >= , <=, !=, LIKE, AND and OR. For example:

SELECT * FROM OrganizationalPerson WHERE  CN != 'NewUser' AND  BaseDN = 'CN=Users,DC=MyDC' LIMIT 5

Insert

To add a OrganizationalPerson, fields can be specified except Id, DN and BaseDN. Required fields that should be provided are RDN and ObjectClass. For example:

INSERT INTO OrganizationalPerson (RDN, ObjectClass) VALUES ('CN=NewUser', 'top;person;organizationalPerson;user;inetOrgPerson')

Update

All columns except Id, DN and BaseDN can be updated by providing the Id in the WHERE clause. For example:

UPDATE OrganizationalPerson SET Description = 'desc' WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Delete

OrganizationalPersons can be deleted by providing the Id of the OrganizationalPerson and issuing a DELETE statement. For example:

DELETE FROM OrganizationalPerson WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Columns


Name	Type	ReadOnly	References	DataFormat	Description
Id [KEY]	String	True			Combined index and DN. Multiple indices are only possible when a column is set to SplitDataByRow.
DN	String	True			The full distinguished name.
RDN	String	False			The relative distinguished name.
BaseDN	String	True			The base distinguished name.
ObjectClass	String	False		DelimitedData	The list of classes from which this class is derived.
SN	String	False		DelimitedData	This attribute contains the family or last name for a user.
CN	String	False		DelimitedData	The name that represents an object. Used to perform searches.
UserPassword	String	False		DelimitedData	The user's password in UTF-8 format. This is a write-only attribute.
TelephoneNumber	String	False		DelimitedData	The primary telephone number.
SeeAlso	String	False		DelimitedData	List of distinguished names that are related to an object.
Description	String	False		DelimitedData	Contains the description to display for an object. This value is restricted as single-valued for backward compatibility in some cases but is allowed to be multi-valued in others. See Remarks.
Title	String	False		DelimitedData	Contains the user's job title. This property is commonly used to indicate the formal job title, such as Senior Programmer, rather than occupational class, such as programmer. It is not typically used for suffix titles such as Esq. or DDS.
X121Address	String	False		DelimitedData	The X.121 address for an object.
RegisteredAddress	String	False		DelimitedData	Specifies a mnemonic for an address associated with an object at a particular city location. The mnemonic is registered in the country/region in which the city is located and is used in the provision of the Public Telegram Service.
DestinationIndicator	String	False		DelimitedData	This is part of the X.500 specification and not used by NTDS.
PreferredDeliveryMethod	String	False		DelimitedData	The X.500-preferred way to deliver to addressee.
TelexNumber	String	False		DelimitedData	A list of alternate telex numbers.
TeletexTerminalIdentifier	String	False		DelimitedData	Specifies the Teletex terminal identifier and, optionally, parameters, for a teletex terminal associated with an object.
InternationalISDNNumber	String	False		DelimitedData	Specifies an International ISDN Number associated with an object.
FacsimileTelephoneNumber	String	False		DelimitedData	Contains telephone number of the user's business fax machine.
Street	String	False		DelimitedData	The street address.
PostOfficeBox	String	False		DelimitedData	The post office box number for this object.
PostalCode	String	False		DelimitedData	The postal or zip code for mail delivery.
PostalAddress	String	False		DelimitedData	The mailing address for the object.
PhysicalDeliveryOfficeName	String	False		DelimitedData	Contains the office location in the user's place of business.
OU	String	False		DelimitedData	The name of the organizational unit.
ST	String	False		DelimitedData	The name of a user's state or province.
L	String	False		DelimitedData	Represents the name of a locality, such as a town or city.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Filter	String	Defines the LDAP filter explicitly, overriding any other values set in the WHERE clause.

Person

Contains personal information about a user.

Table Specific Information

Select

All columns support operators =, >= , <=, !=, LIKE, AND and OR. For example:

SELECT * FROM Person WHERE  ObjectClass_1 = 'top' AND  CN  LIKE 'NewUser' LIMIT 5

Insert

To add a Person, fields can be specified except Id, DN and BaseDN. Required fields that should be provided are RDN, ObjectClass_1, ObjectClass_2, ObjectClass_3, ObjectClass_4. For example:

INSERT INTO Person (RDN, ObjectClass_1, ObjectClass_2, ObjectClass_3, ObjectClass_4) VALUES ('CN=Domain Admins', 'top', 'person', 'organizationalPerson', 'user')

Update

All columns except Id, DN and BaseDN can be updated by providing the Id in the WHERE clause. For example:

UPDATE Person SET Description = 'desc' WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Delete

Persons can be deleted by providing the Id of the Person and issuing a DELETE statement. For example:

DELETE FROM Person WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Columns


Name	Type	ReadOnly	References	DataFormat	Description
Id [KEY]	String	True			Combined index and DN. Multiple indices are only possible when a column is set to SplitDataByRow.
DN	String	True			The full distinguished name.
RDN	String	False			The relative distinguished name.
BaseDN	String	True			The base distinguished name.
ObjectClass_1	String	False		SplitDataByCol	The list of classes from which this class is derived.
ObjectClass_2	String	False		SplitDataByCol	The list of classes from which this class is derived.
ObjectClass_3	String	False		SplitDataByCol	The list of classes from which this class is derived.
ObjectClass_4	String	False		SplitDataByCol	The list of classes from which this class is derived.
SN	String	False		DelimitedData	This attribute contains the family or last name for a user.
CN	String	False		DelimitedData	The name that represents an object. Used to perform searches.
UserPassword	String	False		DelimitedData	The user's password in UTF-8 format. This is a write-only attribute.
TelephoneNumber	String	False		DelimitedData	The primary telephone number.
SeeAlso	String	False		SplitDataByRow	List of distinguished names that are related to an object.
Description	String	False		DelimitedData	Contains the description to display for an object. This value is restricted as single-valued for backward compatibility in some cases but is allowed to be multi-valued in others. See Remarks.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Filter	String	Defines the LDAP filter explicitly, overriding any other values set in the WHERE clause.

Top

The top level class from which all classes are derived.

Table Specific Information

Select

All columns support operators =, >= , <=, !=, LIKE, AND and OR. For example:

SELECT * FROM Top WHERE  CN != 'NewUser' AND  BaseDN = 'CN=Users,DC=MyDC' LIMIT 5

Insert

To add a Top, fields can be specified except Id, DN and BaseDN. Required fields that should be provided are RDN and ObjectClass. For example:

INSERT INTO Top (RDN, ObjectClass) VALUES ('CN=NewUser', 'top;person;organizationalPerson;user;inetOrgPerson')

Update

All columns except Id, DN and BaseDN can be updated by providing the Id in the WHERE clause. For example:

UPDATE Top SET SN = 'test' WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Delete

Tops can be deleted by providing the Id of the Top and issuing a DELETE statement. For example:

DELETE FROM Top WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Columns


Name	Type	ReadOnly	References	DataFormat	Description
Id [KEY]	String	True			Combined index and DN. Multiple indices are only possible when a column is set to SplitDataByRow.
DN	String	True			The full distinguished name.
RDN	String	False			The relative distinguished name.
BaseDN	String	True			The base distinguished name.
ObjectClass	String	False		DelimitedData	The list of classes from which this class is derived.
SN	String	False		DelimitedData	This attribute contains the family or last name for a user.
CN	String	False		DelimitedData	The name that represents an object. Used to perform searches.
GroupType	String	False		DelimitedData	Contains a set of flags that define the type and scope of a group object.
MemberOf	String	False		DelimitedData	The distinguished name of the groups to which this object belongs.
DC	String	False		DelimitedData	The attribute DC for the Domain object class.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Filter	String	Defines the LDAP filter explicitly, overriding any other values set in the WHERE clause.

User

This class is used to store information about an employee or contractor who works for an organization. It is also possible to apply this class to long term visitors.

Table Specific Information

Select

All columns support operators =, >= , <=, !=, LIKE, AND and OR. For example:

SELECT * FROM User WHERE  Title Like '%abc%' AND  AdminCount != '1' LIMIT 5

Insert

To add a User, fields can be specified except Id, DN and BaseDN. Required fields that should be provided are RDN and ObjectClass. For example:

INSERT INTO User (RDN, ObjectClass) VALUES ('CN=TestUser', 'Top; Person; OrganizationalPerson; User')

Update

All columns except Id, DN and BaseDN can be updated by providing the Id in the WHERE clause. For example:

UPDATE User SET PostalCode = '94042' WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Delete

Users can be deleted by providing the Id of the User and issuing a DELETE statement. For example:

DELETE FROM User WHERE Id = '1|CN=NewUser,CN=Users,DC=MyDC'

Columns


Name	Type	ReadOnly	References	DataFormat	Description
Id [KEY]	String	True			Combined index and DN. Multiple indices are only possible when a column is set to SplitDataByRow.
DN	String	True			The full distinguished name.
RDN	String	False			The relative distinguished name.
BaseDN	String	True			The base distinguished name.
ObjectClass	String	False		DelimitedData	The list of classes from which this class is derived.
SN	String	False		DelimitedData	This attribute contains the family or last name for a user.
CN	String	False		DelimitedData	The name that represents an object. Used to perform searches.
UserPassword	String	False		DelimitedData	The user's password in UTF-8 format. This is a write-only attribute.
TelephoneNumber	String	False		DelimitedData	The primary telephone number.
SeeAlso	String	False		DelimitedData	List of distinguished names that are related to an object.
Description	String	False		DelimitedData	Contains the description to display for an object. This value is restricted as single-valued for backward compatibility in some cases but is allowed to be multi-valued in others. See Remarks.
Title	String	False		DelimitedData	Contains the user's job title. This property is commonly used to indicate the formal job title, such as Senior Programmer, rather than occupational class, such as programmer. It is not typically used for suffix titles such as Esq. or DDS.
X121Address	String	False		DelimitedData	The X.121 address for an object.
RegisteredAddress	String	False		DelimitedData	Specifies a mnemonic for an address associated with an object at a particular city location. The mnemonic is registered in the country/region in which the city is located and is used in the provision of the Public Telegram Service.
DestinationIndicator	String	False		DelimitedData	This is part of the X.500 specification and not used by NTDS.
PreferredDeliveryMethod	String	False		DelimitedData	The X.500-preferred way to deliver to addressee.
TelexNumber	String	False		DelimitedData	A list of alternate telex numbers.
TeletexTerminalIdentifier	String	False		DelimitedData	Specifies the Teletex terminal identifier and, optionally, parameters, for a teletex terminal associated with an object.
InternationalISDNNumber	String	False		DelimitedData	Specifies an International ISDN Number associated with an object.
FacsimileTelephoneNumber	String	False		DelimitedData	Contains telephone number of the user's business fax machine.
Street	String	False		DelimitedData	The street address.
PostOfficeBox	String	False		DelimitedData	The post office box number for this object.
PostalCode	String	False		DelimitedData	The postal or zip code for mail delivery.
PostalAddress	String	False		DelimitedData	The mailing address for the object.
PhysicalDeliveryOfficeName	String	False		DelimitedData	Contains the office location in the user's place of business.
OU	String	False		DelimitedData	The name of the organizational unit.
ST	String	False		DelimitedData	The name of a user's state or province.
L	String	False		DelimitedData	Represents the name of a locality, such as a town or city.
UserCertificate	String	False		DelimitedData	Contains the DER-encoded X.509v3 certificates issued to the user. Note that this property contains the public key certificates issued to this user by Microsoft Certificate Service.
NetworkAddress	String	False		DelimitedData	The TCP/IP address for a network segment. Also called the subnet address.
UserAccountControl	String	False		DelimitedData	Flags that control the behavior of the user account.
BadPwdCount	String	False		DelimitedData	The number of times the user tried to log on to the account using an incorrect password. A value of 0 indicates that the value is unknown.
CodePage	String	False		DelimitedData	Specifies the code page for the user's language of choice. This value is not used by Windowsﾂ2000.
HomeDirectory	String	False		DelimitedData	The home directory for the account. If homeDrive is set and specifies a drive letter, homeDirectory must be a UNC path. Otherwise, homeDirectory is a fully qualified local path including the drive letter (for example, DriveLetter:\Directory\Folder). This value can be a null string.
HomeDrive	String	False		DelimitedData	Specifies the drive letter to which to map the UNC path specified by homeDirectory. The drive letter must be specified in the form DriveLetter: where DriveLetter is the letter of the drive to map. The DriveLetter must be a single, uppercase letter and the colon (:) is required.
BadPasswordTime	String	False		DelimitedData	The last time and date that an attempt to log on to this account was made with a password that is not valid. This value is stored as a large integer that represents the number of 100-nanosecond INTEGERs since January 1, 1601 (UTC). A value of zero means that the last time a incorrect password was used is unknown.
LastLogoff	String	False		DelimitedData	This attribute is not used.
LastLogon	String	False		DelimitedData	The last time the user logged on. This value is stored as a large integer that represents the number of 100-nanosecond INTEGERs since January 1, 1601 (UTC). A value of zero means that the last logon time is unknown.
DBCSPwd	String	False		DelimitedData	The account's LAN Manager password.
LocaleID	String	False		DelimitedData	This attribute contains a list of locale IDs supported by this application. A locale ID represents a geographic location, such as a country/region, city, county, and so on.
ScriptPath	String	False		DelimitedData	This attribute specifies the path for the user's logon script. The string can be null.
LogonHours	String	False		DelimitedData	The hours that the user is allowed to logon to the domain.
LogonWorkstation	String	False		DelimitedData	This attribute is not used. See the User-Workstations attribute.
MaxStorage	String	False		DelimitedData	The maximum amount of disk space the user can use. Use the value specified in USER_MAXSTORAGE_UNLIMITED to use all available disk space.
UserWorkstations	String	False		DelimitedData	Contains the NetBIOS or DNS names of the computers running WindowsﾂNT Workstation or Windowsﾂ2000 Professional from which the user can log on. Each NetBIOS name is separated by a comma. Multiple names should be separated by commas.
UnicodePwd	String	False		DelimitedData	The password of the user in WindowsﾂNT one-way format (OWF). Windowsﾂ2000 uses the WindowsﾂNT OWF. This property is used only by the operating system. Note that you cannot derive the clear password back from the OWF form of the password.
OtherLoginWorkstations	String	False		DelimitedData	Non-WindowsﾂNT or LAN Manager workstations from which a user can log on.
NtPwdHistory	String	False		DelimitedData	The password history of the user in WindowsﾂNT one-way format (OWF). Windowsﾂ2000 uses the WindowsﾂNT OWF.
PwdLastSet	String	False		DelimitedData	The date and time that the password for this account was last changed. This value is stored as a large integer that represents the number of 100 nanosecond INTEGERs since January 1, 1601 (UTC). If this value is set to 0 and the User-Account-Control attribute does not contain the UF_DONT_EXPIRE_PASSWD flag, then the user must set the password at the next logon.
PreferredOU	String	False		DelimitedData	The Organizational Unit to show by default on user' s desktop.
PrimaryGroupID	String	False		DelimitedData	Contains the relative identifier (RID) for the primary group of the user. By default, this is the RID for the Domain Users group.
UserParameters	String	False		DelimitedData	Parameters of the user. Points to a Unicode string that is set aside for use by applications. This string can be a null string, or it can have any number of characters before the terminating null character. Microsoft products use this member to store user data specific to the individual program.
ProfilePath	String	False		DelimitedData	Specifies a path to the user's profile. This value can be a null string, a local absolute path, or a UNC path.
OperatorCount	String	False		DelimitedData	Operator count.
AdminCount	String	False		DelimitedData	Indicates that a given object has had its ACLs changed to a more secure value by the system because it was a member of one of the administrative groups (directly or transitively).
AccountExpires	String	False		DelimitedData	The date when the account expires. This value represents the number of 100-nanosecond INTEGERs since January 1, 1601 (UTC). A value of 0 or 0x7FFFFFFFFFFFFFFF (9223372036854775807) indicates that the account never expires.
LmPwdHistory	String	False		DelimitedData	The password history of the user in LAN Manager (LM) one-way format (OWF). The LM OWF is used for compatibility with LAN Manager 2.x clients, Windowsﾂ95, and Windowsﾂ98.
GroupMembershipSAM	String	False		DelimitedData	WindowsﾂNT Security. Down level WindowsﾂNT support.
LogonCount	String	False		DelimitedData	The number of times the account has successfully logged on. A value of 0 indicates that the value is unknown.
ControlAccessRights	String	False		DelimitedData	Used by DS Security to determine which users can perform specific operations on the host object.
DefaultClassStore	String	False		DelimitedData	The default Class Store for a given user.
GroupsToIgnore	String	False		DelimitedData	The Groups-to-Ignore attribute is not currently used.
GroupPriority	String	False		DelimitedData	The Group-Priority attribute is not currently used.
DesktopProfile	String	False		DelimitedData	The location of the desktop profile for a user or group of users. Not used.
DynamicLDAPServer	String	False		DelimitedData	DNS name of server handing dynamic properties for this account.
UserPrincipalName	String	False		DelimitedData	This attribute contains the UPN that is an Internet-style login name for a user based on the Internet standard RFC 822. The UPN is shorter than the distinguished name and easier to remember. By convention, this should map to the user email name. The value set for this attribute is equal to the length of the user's ID and the domain name. For more information about this attribute, see User Naming Attributes.
LockoutTime	String	False		DelimitedData	The date and time (UTC) that this account was locked out. This value is stored as a large integer that represents the number of 100-nanosecond INTEGERs since January 1, 1601 (UTC). A value of zero means that the account is not currently locked out.
UserSharedFolder	String	False		DelimitedData	Specifies a UNC path to the user's shared documents folder. The path must be a network UNC path of the form \\Server\Share\Directory. This value can be a null string.
UserSharedFolderOther	String	False		DelimitedData	Specifies a UNC path to the user's additional shared documents folder. The path must be a network UNC path of the form \\Server\Share\Directory. This value can be a null string.
ServicePrincipalName	String	False		DelimitedData	List of principal names used for mutual authentication with an instance of a service on this computer.
ACSPolicyName	String	False		DelimitedData	String name of an ACS policy that applies to this user.
TerminalServer	String	False		DelimitedData	Opaque data used by the WindowsﾂNT terminal server.
MSMQSignCertificates	String	False		DelimitedData	This attribute contains a number of certificates. A user can generate a certificate per computer. For each certificate we also keep a digest.
MSMQDigests	String	False		DelimitedData	An array of digests of the corresponding certificates in attribute mSMQ-Sign-Certificates. They are used for mapping a digest into a certificate.
MSMQDigestsMig	String	False		DelimitedData	In MSMQ mixed-mode, contains the previous value of mSMQDigests.
MSMQSignCertificatesMig	String	False		DelimitedData	In MSMQ mixed-mode, the attribute contains the previous value of mSMQSignCertificates. MSMQ supports migration from the MSMQ 1.0 DS to the Windowsﾂ2000 DS, and mixed mode specifies a state in which some of the DS severs were not upgraded to Windowsﾂ2000.
MsNPAllowDialin	String	False		DelimitedData	Indicates whether the account has permission to dial in to the RAS server. Do not modify this value directly. Use the appropriate RAS administration function to modify this value.
MsNPCallingStationID	String	False		DelimitedData	The msNPCallingStationID attribute is used internally. Do not modify this value directly.
MsNPSavedCallingStationID	String	False		DelimitedData	The msNPSavedCallingStationID attribute is used internally. Do not modify this value directly.
MsRADIUSCallbackNumber	String	False		DelimitedData	The msRADIUSCallbackNumber attribute is used internally. Do not modify this value directly.
MsRADIUSFramedIPAddress	String	False		DelimitedData	The msRADIUSFramedIPAddress attribute is used internally. Do not modify this value directly.
MsRADIUSFramedRoute	String	False		DelimitedData	The msRADIUSFramedRoute attribute is used internally. Do not modify this value directly.
MsRADIUSServiceType	String	False		DelimitedData	The msRADIUSServiceType attribute is used internally. Do not modify this value directly.
MsRASSavedCallbackNumber	String	False		DelimitedData	The msRASSavedCallbackNumber attribute is used internally. Do not modify this value directly.
MsRASSavedFramedIPAddress	String	False		DelimitedData	The msRASSavedFramedIPAddress attribute is used internally. Do not modify this value directly.
MsRASSavedFramedRoute	String	False		DelimitedData	The msRASSavedFramedRoute attribute is used internally. Do not modify this value directly.
MS-DS-CreatorSID	String	False		DelimitedData	The security ID of the creator of the object that contains this attribute.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Filter	String	Defines the LDAP filter explicitly, overriding any other values set in the WHERE clause.

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

プロパティ	説明
Server	LDAP サーバーのドメイン名、もしくはIP。
Port	LDAP サーバーが起動しているポート。
User	ユーザーの識別名
Password	指定されたユーザーの識別名のパスワード。
BaseDN	結果を指定されたサブツリーに限定する、識別名のベース部分。
UseSSL	Whether or not to use SSL to connect to the server.
LDAPVersion	サーバーに接続し、交信する際に使われるLDAP バージョン。
AuthMechanism	LDAP サーバーに接続する際の認証メカニズム。
Scope	検索の範囲を、サブツリー全体（BaseDN およびすべての下の階層）、単一のレベル（BaseDN および、直接の子階層）、もしくはベースオブジェクト（BaseDN のみ）に制限します。
IntegratedSecurity	Whether or not to use the user's current context when logging in.

SSL

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

Firewall

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

Logging

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

Schema

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Miscellaneous

プロパティ	説明
FollowReferrals	LDAP サーバーにより返されるLDAP リファーラルに従うかどうか。
FriendlyGUID	Whether to return GUID attribute values in a human readable format.
FriendlySID	Whether to return SID attribute values in a human readable format.
MaxRows	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

プロパティ	説明
Server	LDAP サーバーのドメイン名、もしくはIP。
Port	LDAP サーバーが起動しているポート。
User	ユーザーの識別名
Password	指定されたユーザーの識別名のパスワード。
BaseDN	結果を指定されたサブツリーに限定する、識別名のベース部分。
UseSSL	Whether or not to use SSL to connect to the server.
LDAPVersion	サーバーに接続し、交信する際に使われるLDAP バージョン。
AuthMechanism	LDAP サーバーに接続する際の認証メカニズム。
Scope	検索の範囲を、サブツリー全体（BaseDN およびすべての下の階層）、単一のレベル（BaseDN および、直接の子階層）、もしくはベースオブジェクト（BaseDN のみ）に制限します。
IntegratedSecurity	Whether or not to use the user's current context when logging in.

Server

LDAP サーバーのドメイン名、もしくはIP。

解説

このプロパティで、サーバーのドメイン名またはIP アドレスを指定します。この値には、LDAP:\\ portion を含む必要はありません。サーバーのドメイン名、またはIP だけで十分です。

Port

LDAP サーバーが起動しているポート。

解説

LDAP サーバーが起動しているポート。このプロパティは、Server とともに、LDAP サーバーを指定するために使われます。

User

ユーザーの識別名

解説

このフィールドは、Password とともに、LDAP サーバーに対して認証をするために使われます。

Password

指定されたユーザーの識別名のパスワード。

解説

このフィールドは、User とともに、LDAP サーバーに対して認証をするために使われます。

BaseDN

結果を指定されたサブツリーに限定する、識別名のベース部分。

解説

ベースDN の指定は、調べられるエントリー数を限定することにより、大きなサーバーのエントリーの結果を返す際にパフォーマンスを大きく向上させます。

UseSSL

Whether or not to use SSL to connect to the server.

解説

Whether or not to use SSL to connect to the server. Note that a port of 636 will always use SSL.

LDAPVersion

サーバーに接続し、交信する際に使われるLDAP バージョン。

解説

2 または3 に設定します。Sync App は、RFC 1777、2251、およびその他のLDAP RFC で指定された標準LDAP クライアントです。

AuthMechanism

LDAP サーバーに接続する際の認証メカニズム。

解説

デフォルトで、AuthMechanism はSIMPLE に設定されていて、サーバーへのログインには、デフォルトのプレーンテキストでの認証が使われます。 AuthMechanism がDIGESTMD5 に設定されている場合、よりセキュアなDIGEEST-MD5 認証が使われます。 AuthMechanism がNEGOTIATE に設定されている場合、NTLM/NEGOTIATE 認証が使われます。

SIMPLE
DIGESTMD5
NEGOTIATE

Scope

検索の範囲を、サブツリー全体（BaseDN およびすべての下の階層）、単一のレベル（BaseDN および、直接の子階層）、もしくはベースオブジェクト（BaseDN のみ）に制限します。

解説

範囲を限定することで、検索パフォーマンスを大幅に向上させられます。Set Scope to one of the following values:

WholeSubtree: Limit the scope of the search to the BaseDN and all of its descendants.
SingleLevel: Limit the scope of the search to the BaseDN and its direct descendants.
BaseObject: Limit the scope of the search to the base object only (BaseDN).

IntegratedSecurity

Whether or not to use the user's current context when logging in.

解説

By default, the Sync App will use the provided User and Password when authenticating. If this option is enabled, then the Sync App will ignore the current User and Password values and login using the current user's context instead. (Only available when running on Windows)

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

SSLServerCert

TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：


説明	例
フルPEM 証明書（例では省略されています）	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。	C:\cert.cer
公開鍵（例では省略されています）	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint （hex 値はスペースおよびコロン区切り）	ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint （hex 値はスペースおよびコロン区切り）	34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

FirewallType

プロキシベースのファイアウォールで使われるプロトコル。

解説

このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。


タイプ	デフォルトポート	説明
TUNNEL	80	これが設定されている場合、Sync App はLDAP への接続を開き、プロキシを経由して通信が行われます。
SOCKS4	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 4 プロキシ経由で送信し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 5 プロキシ経由で送信します。プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

FirewallServer

プロキシベースのファイアウォールの名前もしくはIP アドレス。

解説

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。

FirewallPort

プロキシベースのファイアウォールのTCP ポート。

解説

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

FirewallUser

プロキシベースのファイアウォールに認証するために使うユーザー名。

解説

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

FirewallPassword

プロキシベースのファイアウォールへの認証に使われるパスワード。

解説

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

LogModules

ログファイルに含めるコアモジュール。

解説

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログページを参照してください。

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。

解説

Sync App のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\LDAP Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

BrowsableSchemas

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、パフォーマンスが向上します。

Tables

このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。

解説

テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

Views

使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

解説

ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

プロパティ	説明
FollowReferrals	LDAP サーバーにより返されるLDAP リファーラルに従うかどうか。
FriendlyGUID	Whether to return GUID attribute values in a human readable format.
FriendlySID	Whether to return SID attribute values in a human readable format.
MaxRows	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

FollowReferrals

LDAP サーバーにより返されるLDAP リファーラルに従うかどうか。

解説

リファーラルに従う場合、リファーラルサーバーからのデータのみが返されます。サーバーに直接接続するように接続文字列を変更しない限り、追加、更新、削除はできません。

FriendlyGUID

Whether to return GUID attribute values in a human readable format.

解説

When inspecting object attributes this setting determines whether GUID attributes such as "objectGUID" are returned as binary objects or converted into a human readable string such as "708d9374-d64a-49b2-97ea-489ddc717703". When set to True a friendly string value is returned. When set to False (default) a base 64 encoded string of the binary object is returned.

FriendlySID

Whether to return SID attribute values in a human readable format.

解説

When inspecting object attributes this setting determines whether SID attributes such as "objectSid" are returned as binary objects or converted into a human readable string such as "S-1-5-21-4272240814-246508344-1325542772-12464". When set to True a friendly string value is returned. When set to False (default) a base 64 encoded string of the binary object is returned.

MaxRows

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

解説

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

Other

これらの隠しプロパティは特定のユースケースでのみ使用されます。

解説

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット


DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

PseudoColumns

このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。

解説

Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。

Timeout

タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

解説

Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。

Timeout の有効期限が切れても処理が完了していない場合は、Sync App は例外をスローします。

UserDefinedViews

カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

解説

ユーザー定義ビューは、UserDefinedViews.json というJSON 形式のコンフィギュレーションファイルで定義されています。Sync App は、このファイルで指定されたビューを自動的に検出します。

また、複数のビュー定義を持ち、UserDefinedViews 接続プロパティを使用して制御することも可能です。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

このユーザー定義ビューのコンフィギュレーションファイルは、次のようにフォーマットされています。

各ルートエレメントはビューの名前を定義します。
各ルートエレメントには、query と呼ばれる子エレメントが含まれており、この子エレメントにはビューのカスタムSQL クエリが含まれています。

次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM User WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

UserDefinedViews 接続プロパティを使用して、JSON コンフィギュレーションファイルの場所を指定します。次に例を示します。

"UserDefinedViews", "C:\\Users\\yourusername\\Desktop\\tmp\\UserDefinedViews.json"