はじめに
ONTAPでは、クラスタやSVMの管理ユーザ認証にディレクトリサービス(LDAP)を利用することで、ユーザ情報を外部ディレクトリで一元管理できます。本記事では、ONTAPの管理ユーザをLDAPと連携し、LDAP上に登録したユーザでONTAPへログインできる環境を構築します。
最終的には、通信を暗号化したLDAPSやLDAP StartTLSによる構成について記載する予定ですが、いきなりTLSを含めると、LDAPの設定に加えて証明書やTLS通信の問題も同時に切り分ける必要がありますので、前段階として、TCP/389を使用したシンプルな平文LDAP構成でONTAPとLDAPサーバ間の連携を確認します。
Dockerを利用してOpenLDAPサーバの構築、ユーザ登録、ONTAP側のLDAP設定、そしてLDAPユーザによる管理ログインまでを順番に確認します。
何をしたい?できる?
- AlmaLinux上にDockerを使いOpenLDAP環境を構築
- LDAP上のユーザをONTAPの管理アカウントとして登録
LDAPとは
LDAP(Lightweight Directory Access Protocol)とは、ネットワーク上にあるユーザやグループなどの情報を参照するための仕組みで、端的に言うと組織内のユーザ情報を管理する「電子的な名簿」にアクセスすることができます。
LDAPサーバには、ユーザ名、所属、メールアドレス、ユーザID、グループなどの情報が階層構造で登録され、検索だけでなく、認証(Bind)、追加、変更、削除などの操作も可能となっています。
LDAPでは、各データをDN(Distinguished Name:識別名)によって特定し、uid=user01,ou=People,dc=example,dc=comについては、「example.comという組織のPeople部門にあるuser01」という位置を表します。
なお、dc は Domain Component の略で、ドメイン名を構成する要素を表します。
サーバやストレージ製品のアカウントをLDAPと連携すると、製品ごとに管理ユーザを登録する代わりに、LDAPに登録された共通のユーザ情報を利用して認証や権限管理を行うことができます。
本記事では以下のようなディレクトリ構成を作成します。
記事における環境情報
本記事では、以下の環境で検証を実施しています。
- ONTAP: 9.19.1
- AlmaLinux 10.2
- Docker 29.9.2
- OpenLDAP 2.6.10
環境のイメージとしては以下の通りです。
設定手順
1. OpenLDAP環境の構築
1-1. Dockerを導入
公式リポジトリを追加するための dnf config-manager コマンドを使うために dnf-utils(または dnf-plugins-core)を事前に導入します
> sudo dnf install -y dnf-utils
[sudo] userXXX のパスワード:
メタデータの期限切れの最終確認: 1:16:58 前の 2026年10月29日 12時31分23秒 に実施しました。
依存関係が解決しました。
===============================================================================================================================================================
パッケージ アーキテクチャー バージョン リポジトリー サイズ
===============================================================================================================================================================
インストール:
yum-utils noarch 4.7.0-10.el10 baseos 33 k
トランザクションの概要
(中略)
完了しました!
DockerのリポジトリのURLを追加します。
> sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
repo の追加: https://download.docker.com/linux/centos/docker-ce.repo
Docker Engine、CLI、Containerd、Composeプラグイン等の導入を実施します。
> sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Docker CE Stable - x86_64 88 kB/s | 28 kB 00:00
依存関係が解決しました。
===============================================================================================================================================================
パッケージ アーキテクチャー バージョン リポジトリー サイズ
===============================================================================================================================================================
インストール:
containerd.io x86_64 2.4.2-3.el10 docker-ce-stable 35 M
docker-buildx-plugin x86_64 0.38.1-1.el10 docker-ce-stable 18 M
docker-ce x86_64 3:29.9.2-1.el10 docker-ce-stable 26 M
docker-ce-cli x86_64 1:29.9.2-1.el10 docker-ce-stable 8.9 M
docker-compose-plugin x86_64 5.6.1-1.el10 docker-ce-stable 8.4 M
依存関係のインストール:
container-selinux noarch 4:2.248.0-1.el10_2 appstream 62 k
(中略)
完了しました!
次回のシステム起動時にDockerを自動的に開始するよう設定し、操作ユーザをDockerグループへ追加してから挙動を確認します。
# Serviceの有効化と確認
> sudo systemctl enable --now docker
Created symlink '/etc/systemd/system/multi-user.target.wants/docker.service' → '/usr/lib/systemd/system/docker.service'.
> sudo systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: disabled)
(中略)
# Versionの確認
> docker --version
Docker version 29.9.2, build a82e528
> docker compose version
Docker Compose version v5.6.1
# Dockerを導入時に dockerグループは作成されるので、操作ユーザをグループへ追加
> sudo usermod -aG docker "$USER"
# ログインセッションを終了することなく一時的に有効なグループを切り替え
> newgrp docker
Dockerの動作を確認します。
> docker run --rm hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
4f55086f7dd0: Pull complete
d5e71e642bf5: Download complete
Digest: sha256:c567b231f65614688711a75f31518a064258a51d442117a3e771a3a8fdba78ef
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
(中略)
For more examples and ideas, visit:
https://docs.docker.com/get-started/
本記事では、検証用という事もありiptableやFirewallについては設定しないで進めます。
1-2. DockerでOpenLDAPのコンテナを構築
まずは作業用ディレクトリを作成します。
# ディレクトリ作成
> mkdir -p ~/openldap-ontap/{config,ldif,secrets}
# ディレクトリが作成されている事の確認
> cd ~/openldap-ontap
> ls
config ldif secrets
# 後でパスワードファイルを入れるディレクトリへ所有者のみ権限を付与
> chmod 700 secrets
管理パスワードの用意を行います。パスワードは環境に合わせて適宜変更して下さい。
# LDAP管理者パスワードファイルの作成
> printf '%s' 'test1Pass2word3' > secrets/ldap_admin_password.txt
> chmod 600 secrets/ldap_admin_password.txt
作成するファイルであるDockerfile、slapd.conf.template、docker-entrypoint.shは、次のように役割分担されています。
| ファイル名 | 説明 |
|---|---|
| Dockerfile | OpenLDAPを動かす箱を作る |
| slapd.conf.template | どんなLDAPサーバにするか定義する |
| docker-entrypoint.sh | 起動時に設定を完成させてLDAPを動かす |
最初にDockerfileを用意します。
必要なソフトウェアと設定テンプレートだけをイメージに入れ、コンテナ起動時に docker-entrypoint.sh で OpenLDAP の設定を生成する形にしてます。また、ldap-utilsをInstallするようにしているので、後述するldapaddによる追加や登録ユーザの確認はコンテナを指定して実行することになります。
> cat Dockerfile
FROM debian:13-slim
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
slapd ldap-utils ca-certificates tini \
&& rm -rf /var/lib/apt/lists/*
COPY config/slapd.conf.template /opt/openldap/slapd.conf.template
COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
RUN chmod 0755 /usr/local/bin/docker-entrypoint.sh \
&& rm -rf /etc/ldap/slapd.d/* \
&& rm -rf /var/lib/ldap/* \
&& mkdir -p /var/lib/ldap /etc/ldap/slapd.d /run/slapd
EXPOSE 389
ENTRYPOINT ["/usr/bin/tini","--","/usr/local/bin/docker-entrypoint.sh"]
configフォルダ上に、slapd.conf.templateファイルを用意します。
dc=example,dc=com をルートとしたLDAPデータベースを作り、admin1を管理者、ontap-bindをONTAP検索用アカウントとして、RFC2307系のユーザ・グループ情報をONTAPから検索できるようにする設定としています。
> cat config/slapd.conf.template
include /etc/ldap/schema/core.schema
include /etc/ldap/schema/cosine.schema
include /etc/ldap/schema/inetorgperson.schema
include /etc/ldap/schema/nis.schema
modulepath /usr/lib/ldap
moduleload back_mdb
pidfile /run/slapd/slapd.pid
argsfile /run/slapd/slapd.args
loglevel stats
database mdb
maxsize 1073741824
suffix "dc=example,dc=com"
rootdn "cn=admin1,dc=example,dc=com"
rootpw @@ADMIN_HASH@@
directory /var/lib/ldap
index objectClass eq
index uid,uidNumber,gidNumber eq
index cn,memberUid eq
access to attrs=userPassword
by dn.exact="cn=admin1,dc=example,dc=com" manage
by dn.exact="uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com" read
by self write
by anonymous auth
by * none
access to *
by dn.exact="cn=admin1,dc=example,dc=com" manage
by dn.exact="uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com" read
by self read
by * none
docker-entrypoint.shファイルを用意します。
Dockerイメージには管理者パスワードを埋め込まず、コンテナ初回起動時にSecretからパスワードを読み込み、ハッシュ化したうえでLDAP設定を生成し、cn=config形式の設定でOpenLDAPを起動する仕組みになっています。
> cat docker-entrypoint.sh
#!/bin/sh
set -eu
CONF_DIR=/etc/ldap/slapd.d
DATA_DIR=/var/lib/ldap
TEMPLATE=/opt/openldap/slapd.conf.template
ADMIN_PASSWORD_FILE=${LDAP_ADMIN_PASSWORD_FILE:-/run/secrets/ldap_admin_password}
if [ ! -r "$ADMIN_PASSWORD_FILE" ]; then
echo "ERROR: LDAP admin password file is not readable" >&2
exit 1
fi
mkdir -p "$CONF_DIR" "$DATA_DIR" /run/slapd
if [ ! -f "$CONF_DIR/cn=config.ldif" ]; then
ADMIN_HASH="$(slappasswd -s "$(cat "$ADMIN_PASSWORD_FILE")")"
sed "s|@@ADMIN_HASH@@|${ADMIN_HASH}|" \
"$TEMPLATE" > /tmp/slapd.conf
rm -rf "${CONF_DIR:?}/"*
slaptest -f /tmp/slapd.conf -F "$CONF_DIR"
chown -R openldap:openldap "$CONF_DIR" "$DATA_DIR"
chmod 0700 "$DATA_DIR"
rm -f /tmp/slapd.conf
fi
chown -R openldap:openldap /run/slapd "$CONF_DIR" "$DATA_DIR"
exec /usr/sbin/slapd \
-u openldap -g openldap \
-F "$CONF_DIR" \
-h "ldap://0.0.0.0:389/ ldapi:///" \
-d 256
> chmod 755 docker-entrypoint.sh
docker-compose.ymlファイルを用意します。
コンテナの起動方法、ポート公開、データの永続化、Secret、ヘルスチェックなどの設定を記載します。本構成では、RFC2307を扱えるOpenLDAP環境をDocker上に構築し、管理者パスワードはSecret、LDAP設定およびデータはVolumeで保持します。また、TCP/389の平文LDAPで動作確認を行います。
> cat docker-compose.yml
services:
openldap:
build:
context: .
dockerfile: Dockerfile
image: local/openldap-rfc2307:2.6-lab-1
container_name: openldap-plain389
hostname: ldap.example.local
environment:
LDAP_ADMIN_PASSWORD_FILE: /run/secrets/ldap_admin_password
ports:
- "389:389"
secrets:
- ldap_admin_password
volumes:
- ldap_data:/var/lib/ldap
- ldap_config:/etc/ldap/slapd.d
- ./ldif:/ldif:ro
healthcheck:
test:
- CMD-SHELL
- ldapsearch -x -H ldap://127.0.0.1:389 -b '' -s base namingContexts >/dev/null 2>&1
interval: 10s
timeout: 5s
retries: 5
start_period: 10s
restart: unless-stopped
secrets:
ldap_admin_password:
file: ./secrets/ldap_admin_password.txt
volumes:
ldap_data:
ldap_config:
ベースイメージを更新してからビルドし、コンテナを起動します。
# Dockerfile の FROM で指定されたベースイメージを、最新版に更新してからビルド
> docker compose build --pull
[+] Building 23.5s (12/12) FINISHED
=> [internal] load local bake definitions 0.0s
(中略)
[+] build 1/1
✔ Image local/openldap-rfc2307:2.6-lab-1 Built
# コンテナをバックグラウンド(裏側)で起動
> docker compose up -d
(中略)
✔ Container openldap-plain389 Started 0.7s
# 起動状態の確認
> docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
openldap-plain389 local/openldap-rfc2307:2.6-lab-1 "/usr/bin/tini -- /u…" openldap 9 seconds ago Up Less than a second (health: starting) 0.0.0.0:389->389/tcp, [::]:389->389/tcp
# Logの確認
> docker compose logs --tail=100 openldap
openldap-plain389 | 6ae2d832.01dcc81d 0x7f8dd5e4a140 @(#) $OpenLDAP: slapd 2.6.10+dfsg-1 (May 29 2025 23:41:48) $
(中略)
openldap-plain389 | 6ae2d84b.0d6ee949 0x7f8d8ffff6c0 conn=1002 op=1 SRCH attr=namingContexts
openldap-plain389 | 6ae2d84b.0d702ad0 0x7f8d8ffff6c0 conn=1002 op=1 SEARCH RESULT tag=101 err=0 qtime=0.000017 etime=0.000125 nentries=1 text=
openldap-plain389 | 6ae2d84b.0d73cd11 0x7f8d94ffe6c0 conn=1002 op=2 UNBIND
openldap-plain389 | 6ae2d84b.0d74ce91 0x7f8d94ffe6c0 conn=1002 fd=11 closed
# OpenLDAPのVersion確認
> docker compose exec openldap slapd -VV
@(#) $OpenLDAP: slapd 2.6.10+dfsg-1 (May 29 2025 23:41:48) $
Debian OpenLDAP Maintainers <pkg-openldap-devel@lists.alioth.debian.org>
LDAP環境の土台となるディレクトリツリーを作成するLDIFファイルの作成を実施します。
ldifファイルにパスワードを記述する際に平文で記載するのは避けたいので、slappasswdを使ってSSHAを生成し、出力されたSSHAを使用して、ユーザ設定用のldifファイルを作成します。
今回の構成では、dc=example,dc=com をルートにして、その直下へ 一般ユーザ用、グループ用、ONTAPなどのサービスアカウント用の3つの入れ物(OU)を作成しています。
# SSHAの生成
> docker compose exec -it openldap slappasswd
New password:
Re-enter new password:
{SSHA}p88XXXXXXXXXXnHYw6zAfm4dr
# LDAP環境の土台となるLDIFファイルの作成
> cat ldif/00-base.ldif
dn: dc=example,dc=com
objectClass: top
objectClass: dcObject
objectClass: organization
dc: example
o: Example Local
dn: ou=People,dc=example,dc=com
objectClass: top
objectClass: organizationalUnit
ou: People
dn: ou=Groups,dc=example,dc=com
objectClass: top
objectClass: organizationalUnit
ou: Groups
dn: ou=ServiceAccounts,dc=example,dc=com
objectClass: top
objectClass: organizationalUnit
ou: ServiceAccounts
次に、実際のアカウントとグループを登録するためのファイルを作成します。
本記事では、「ONTAP自身がLDAP検索に使う ontap-bind」、「ONTAP管理者として扱いたい ontapadmin1」「その管理者が所属する ontap-admins グループ」の3つを作成しています。
ontap-bind は、ONTAPがLDAPサーバに接続して、ユーザやグループの情報を検索するためのアカウントとして想定しており、「LDAPにどのユーザがいるのか検索したい」というときに、LDAPサーバに接続するためのサービスアカウントになります。
objectClass: inetOrgPersonを使用する場合、cn(Common Name)やsn(Surname)などの必須属性を設定する必要があります。
各エントリの記載に関する内容はLDAPのマニュアルを参照頂ければと思います。
また、userPasswordは先ほどSSHAの生成で実施した内容を記載します。
> cat ldif/10-accounts.ldif
dn: uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
uid: ontap-bind
cn: ONTAP LDAP Bind
sn: Bind
description: Read-only LDAP bind account for ONTAP
userPassword: {SSHA}p88XXXXXXXXXXnHYw6zAfm4dr
dn: uid=ontapadmin1,ou=People,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
objectClass: posixAccount
uid: ontapadmin1
cn: ONTAP Administrator
sn: Administrator
uidNumber: 20001
gidNumber: 20001
homeDirectory: /nonexistent
loginShell: /sbin/nologin
gecos: ONTAP Administrator
userPassword: {SSHA}p88XXXXXXXXXXnHYw6zAfm4dr
dn: cn=ontap-admins,ou=Groups,dc=example,dc=com
objectClass: top
objectClass: posixGroup
cn: ontap-admins
gidNumber: 20001
memberUid: ontapadmin1
ファイルの投入を実施します。
OpenLDAPサーバ構築時に、ldap-utilsをInstallするといったコンテナ構成にしているので、ファイルの投入はコンテナを指定して実施します。
# LDAPの土台部分の投入
> docker compose exec -T openldap ldapadd -x -H ldap://127.0.0.1:389 -D "cn=admin1,dc=example,dc=com" -y /run/secrets/ldap_admin_password -f /ldif/00-base.ldif
adding new entry "dc=example,dc=com"
adding new entry "ou=People,dc=example,dc=com"
adding new entry "ou=Groups,dc=example,dc=com"
adding new entry "ou=ServiceAccounts,dc=example,dc=com"
# アカウントの記載したファイルの投入
> docker compose exec -T openldap ldapadd -x -H ldap://127.0.0.1:389 -D "cn=admin1,dc=example,dc=com" -y /run/secrets/ldap_admin_password -f /ldif/10-accounts.ldif
adding new entry "uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com"
adding new entry "uid=ontapadmin1,ou=People,dc=example,dc=com"
adding new entry "cn=ontap-admins,ou=Groups,dc=example,dc=com"
コンテナを指定して、登録ユーザを検索できるか確認します。
本検証環境では構成を単純化するため、ontap-bind に userPassword 属性の読み取り権限を付与していますが実環境では必要な属性のみ参照できるよう、ACLを適切に制限してください。
> docker compose exec openldap ldapsearch -LLL -x -H ldap://127.0.0.1:389 -D "uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com" -W -b "ou=People,dc=example,dc=com" '(&(objectClass=posixAccount)(uid=ontapadmin1))'
Enter LDAP Password:
dn: uid=ontapadmin1,ou=People,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
objectClass: posixAccount
uid: ontapadmin1
cn: ONTAP Administrator
sn: Administrator
uidNumber: 20001
gidNumber: 20001
homeDirectory: /nonexistent
loginShell: /sbin/nologin
gecos: ONTAP Administrator
userPassword:: e1NTSEF9cDg4VjA3TDJRRHUvb1NqeVJpNnZuSFl3NnpBZm00ZHI=
2. ONTAP側の設定
2-1. ldap client createによるLDAPクライアント構成を作成
ONTAPの管理SVMであるPS-A400 からコンテナで作成したOpenLDAPへのLDAPクライアント構成を設定します。
ontap-bindというユーザを使用したSimple Bindで接続し、dc=example,dc=com 以下にあるRFC2307形式のユーザ/グループ情報を参照するためのLDAPクライアント指定を実施します。
> vserver services name-service ldap client create -vserver PS-A400 -client-config openldap-mgm -ldap-servers 172.16.22.10 -schema RFC-2307 -port 389 -base-dn "dc=example,dc=com" -bind-dn "uid=ontap-bind,ou=ServiceAccounts,dc=example,dc=com" -min-bind-level simple -use-start-tls false -ldaps-enabled false
Enter password:
Confirm password:
作成したLDAPクライアント構成を管理SVMへ関連付けます。
> vserver services name-service ldap create -vserver PS-A400 -client-config openldap-mgm
Warning: Only one LDAP server is configured in the LDAP client configuration "openldap-mgm". Configure more than one LDAP server to avoid a
single-point-of-failure.
"LDAP" is not present as a name service source in any of the name service databases, however, a valid LDAP configuration was found for Vserver
"PS-A400". Either configure "LDAP" as a name service source using the "vserver services name-service ns-switch" command or remove the "LDAP"
configuration from the Vserver "PS-A400" using the "vserver services name-service ldap delete" command.
2-2. ONTAPのName Service Switch設定
管理SVMである PS-A400 に対して、ユーザ情報(passwd)とグループ情報(group)を「ONTAP内部のローカル情報 → LDAP」の順番で検索するように設定します。
ONTAPのName Service Switchは、UNIX/Linuxの /etc/nsswitch.conf に相当する仕組みで、「ユーザやグループをどこから、どの順番で探すか」をSVM単位で決定します。
> vserver services name-service ns-switch modify -vserver PS-A400 -database passwd -sources files,ldap
> vserver services name-service ns-switch modify -vserver PS-A400 -database group -sources files,ldap
> vserver services name-service ns-switch show -vserver PS-A400
Source
Vserver Database Order
--------------- ------------ ---------
PS-A400 hosts files,
dns
PS-A400 group files,
ldap
PS-A400 passwd files,
ldap
3 entries were displayed.
Lookupの実施を行います。
ontapadmin1というLDAP上のユーザを検索すると、LDAPから正しくユーザ情報を取得できるかを確認します。
# Advanced Modeに変更
> set -privilege advanced
Warning: These advanced commands are potentially dangerous; use them only when directed to do so by NetApp personnel.
Do you want to continue? {y|n}: y
# 検索の実施
*> vserver services name-service getxxbyyy getpwbyname -vserver PS-A400 -username ontapadmin1 -show-source true -node PS-A400-01
Source used for lookup: LDAP
pw_name: ontapadmin1
pw_passwd: {SSHA}p88XXXXXXXXXXnHYw6zAfm4dr
pw_uid: 20001
pw_gid: 20001
pw_gecos: ONTAP Administrator
pw_dir: /nonexistent
pw_shell: /sbin/nologin
2-3. LDAPユーザへのONTAP管理ロールの割り当て
LDAP上のユーザにONTAPの管理ロールの割り当てを実施します。本記事ではSSHのみ利用できるように設定します。
> security login create -vserver PS-A400 -user-or-group-name ontapadmin1 -application ssh -authentication-method nsswitch -role admin -is-ns-switch-group no -is-ldap-fastbind no
> security login show -vserver PS-A400 -user-or-group-name ontapadmin1
Vserver: PS-A400
Second
User/Group Authentication Acct Authentication
Name Application Method Role Name Locked Method
-------------- ----------- ------------- ---------------- ------ --------------
ontapadmin1 ssh nsswitch admin - none
LDAP上のユーザを使用してONTAPへSSHでログインし、ログインユーザの確認を行います。
> security login whoami
User: ontapadmin1
Role: admin
Trust Score: -
参考及びリンク
ONTAPでLDAPを設定する方法:マルチプロトコルNAS ID管理



