Interstage Application Server Smart Repository運用ガイド

4.2.2.2 LDIF標準形式

　エントリの情報を記述する標準形式について説明します。
　例中に記載のオブジェクトクラス、属性については、それぞれ、“オブジェクトクラス一覧”、“属性一覧”を参照してください。

2つのエントリを記述した標準形式

version: 1
# 1つ目のエントリ
dn: cn=Taro Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
objectclass: top
objectclass: person
objectclass: organizationalPerson
cn: Taro Fujitsu
sn: Fujitsu

# 2つ目のエントリ
dn: cn=Jiro Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
objectclass: top
objectclass: person
objectclass: organizationalPerson
cn: Jiro Fujitsu
sn: Fujitsu

• version行
  　LDIFファイルの先頭行には、LDIFのバージョンを指定します。省略された場合は、バージョン1で動作します。リポジトリで使用する場合は、バージョン1を指定します。
  　1 ： RFC2849で規定された機能
  　0 ： michigan大学のldap-3.3で使用されているLDIFの機能
  
• コメント行
  　先頭行が“#”（シャープ）で始まる行は、コメント行として無視されます。
• エントリ情報
  　1つ以上のエントリ情報から構成され、各エントリ情報の間には空白行を1行挿入して区分します。各エントリ情報は、DN（識別名）、1つ以上のオブジェクトクラス、1つ以上の属性定義から構成されます。次のような書式で記述します。

  dn: エントリのDN
  objectclass: オブジェクトクラス
  objectclass: オブジェクトクラス
  属性型: 属性値
  属性型: 属性値

  
  

  　各行の、dn、objectclass、属性型と、値を区切る記号として“:”（コロン）を使用します。“:”（コロン）の前後の空白は無視されます。なお、属性値に外部ファイルの内容を設定する場合（ldapmodifyコマンドで、-bオプションを使用しない場合）、または属性値にバイナリ値を設定する場合は、“:”（コロン）が属性と属性値の区切り文字ではないため、“:”（コロン）の後に空白は指定できません。
  

• 空白行
  　エントリ情報を区分します。
  
  
  • 先頭に空白行がある場合はLDIFファイル内のすべての行が無視されます。
  • 空白行が続く場合は以降の行は無視されます。

◆行が長い時

　DNや属性値が長すぎる場合は、折り返して複数行で記述することができます。この時、継続行であることを示すために、行の先頭1文字を空白とし、2文字目から属性値の続きを記述します。行の先頭が空白の場合、その行は、前の行の継続行とみなされます。

長い属性値を折り返す場合

dn: cn=Hanako Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
changetype: add
objectclass: top
objectclass: person
objectclass: organizationalPerson
cn: Hanako Fujitsu
sn: Fujitsu
description: Hanako is good at English, German, and French.
 She has experience in overseas assignment.

◆属性値を外部ファイルから参照する時

　属性値に、外部ファイルの内容を設定するには、以下の形式で記述します。DNにはファイルからの読み込みは行えません。

• ldapmodifyコマンドで、-bオプションを使用する場合

  属性名: ファイル名

  
  
• 上記以外の場合

  属性名:< ファイル名(注)

  (注)“:”（コロン）と“<”（小なり）の間には空白を入れないで記述します。“:”（コロン）と“<”（小なり）の間に空白を入れた場合、“:”（コロン）以降に記載した文字列が属性値として登録されます。

　上記の形式で属性値を指定した場合、指定されたファイルの内容をこの属性の属性値として使用します。ファイル名は、リポジトリ内に格納されません。
　ファイル名には以下の形式での指定が可能です。

• フルパスでの指定
  　指定できるファイルは、テキストファイルでかつ使用している文字がASCIIコード系の文字である必要があります。ファイルは、あらかじめBase64符号化しておく必要があります。

  

  　ファイル名は“C:\”などドライブ名で始まるフルパス形式で記述します。

  

  　ファイル名は“/”(スラッシュ)で始まるフルパス形式で記述します。

• URLでの指定
  　ファイルへのパスをURL形式で指定します。パスの区切り記号には、“\”（エンマーク）または“/”（スラッシュ）を使用できます。
  　URLで指定できるスキーム（URLが指し示すリソースの種類）は、fileスキームのみです。またURLで指定するホスト名およびポート番号は無視されます。そのため、後に続くフルパスとして指定できるファイルは、ローカルなファイルのみです。ファイルの内容は、文字の場合はUTF-8、バイナリの場合、そのままバイナリの形式にしてください。

  file://フルパス

  
  

属性値をファイルから読み込む場合

#Taro_photo.jpgはバイナリ
dn: cn=Taro Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
objectclass: top
objectclass: person
objectclass: organizationalPerson
objectclass: inetOrgPerson
cn: Taro Fujitsu
sn: Fujitsu
jpegPhoto:< file://C:\home\Tarou\Taro_photo.jpg

属性値をファイルから読み込む場合

#Taro_photo.jpgはバイナリ
dn: cn=Taro Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
objectclass: top
objectclass: person
objectclass: organizationalPerson
objectclass: inetOrgPerson
cn: Taro Fujitsu
sn: Fujitsu
jpegPhoto:< file:///home/Taro/Taro_photo.jpg

◆バイナリの表記

　属性値にバイナリ値を設定するには、以下の形式で記述します。

• Base64符号化した値を直接記述する場合1

  属性名:: 属性値（Base64符号化）

  
  

  　

• Base64符号化した値を直接記述する場合2

  属性名;binary:: 属性値（Base64符号化）

  　

• 外部ファイルの内容を指定する場合

  属性名:< file://フルパス

  　バイナリ値に外部ファイルが指定された場合は、外部ファイルの内容のみがBase64符号化形式でリポジトリに格納され、ファイル名は格納されません。

Base64符号化した値を直接記述する場合

dn: cn=Taro Fujitsu,ou=User,ou=interstage,o=fujitsu,dc=com
objectclass: top
objectclass: person
objectclass: organizationalPerson
objectclass: inetOrgPerson
cn: Taro Fujitsu
sn: Fujitsu
jpegPhoto::gqCCo2C0ILTgtaC2Q0KgtyC3YLegt+C4A0KguKCooLkgqa
 C5g0KgueC6ILpguqC6w0KgvENCg==