Lightwave とは

Project Lightwave は、エンタープライズにおけるクラウドネイティブアプリケーションの重要なセキュリティ、ガバナンス、コンプライアンスの課題に対応する、エンタープライズグレードのアイデンティティおよびアクセス管理サービスで構成されるオープンソースプロジェクトです。Project Photon との統合により、Project Lightwave はコンテナワークロードのセキュリティとガバナンスを提供できます。また、Project Lightwave は、シングルサインオン、認証、認可、認証局、さらにインフラストラクチャとアプリケーションスタック全体にわたる証明書キー管理サービスなど、さまざまなユースケースにも対応できます。Project Lightwave は、プロダクション品質のコードと、マルチテナントでスケーラブル、かつ高可用性のマルチマスターレプリケーショントポロジを備えたエンタープライズグレードのアーキテクチャに基づいています。

Project Lightwave は、以下の主要なアイデンティティインフラストラクチャ要素で構成されています。

• Lightwave Directory Service - 標準ベースで、マルチテナント、マルチマスター、高スケーラブルな LDAP v3 ディレクトリサービス。最も要求の厳しいアプリケーションや複数のチームがエンタープライズインフラストラクチャを使用できるようにします。
• Lightwave Certificate Authority - ディレクトリ統合型認証局。インフラストラクチャ全体での証明書ベースの操作とキー管理を簡素化します。
• Lightwave Certificate Store - 証明書の資格情報を保存するエンドポイント証明書ストア。
• Lightwave Authentication Services - Kerberos、OAuth 2.0/OpenID Connect、SAML、WSTrust をサポートするクラウド認証サービス。データセンター内の他の標準ベースのテクノロジーとの相互運用を可能にします。
• Lightwave Domain Name Services - ディレクトリ統合型ドメインネームサービス。ディレクトリサービスおよび認証サービス (STS) への Kerberos 認証を保証します。また、SRV レコードを使用したサイトアフィニティと DNS フォワーダーもサポートします。

依存関係

Lightwave は以下の既存のオープンソースパッケージを使用しています。

1. OpenLDAP

OpenLDAP は LDAP サーバーのプロトコルヘッドとして使用され、OpenLDAP Lightning MDB 組込みデータベースが基盤となる LDAP ストアとして使用されます。

1. Heimdal Kerberos

Heimdal Kerberos スタックは Kerberos プロトコルヘッドとして使用されます。

1. DCE/RPC

DCE/RPC は Lightwave LDAP ディレクトリサービスの設定のための制御インフラストラクチャとして使用されます。

1. Likewise Open

Likewise Open スタックは、そのサービス制御インフラストラクチャ、レジストリインフラストラクチャ、および NT セキュリティ記述子のサポートに使用されます。Likewise Open は、Lightwave クライアントに ssh サポートを提供する簡単なメカニズムも提供します。最初の3つのパッケージは Lightwave プロジェクト内に同梱されています。Likewise Open プロジェクトは別のプロジェクトであり、別の git リポジトリからビルドする必要があります。バイナリ RPM も利用できます。リポジトリを追加する手順については、以下の手順を参照してください。

ソースコード

git clone ssh://[email protected]/vmware/lightwave.git

ビルド

これらのビルド手順は、VMware の Photon Linux ディストリビューション上で Lightwave をビルドするためのものです。(他のプラットフォームでのビルドについては wiki を参照してください)

1. lightwave の git リポジトリを Photon (Full) インストール環境にクローンします。

2. Photon システムに likewise-open-devel-6.2..x86_64.rpm がインストールされていることを確認します。

3. [workspace]/build で 実行 ./build_photon.sh* を実行します。

4. ビルドが成功すると、以下の RPM が [workspace]/build/stage ディレクトリに作成されます。

   1. lightwave-1.3.0-0.x86_64.rpm

   2. lightwave-client-1.3.0-0.x86_64.rpm

   3. lightwave-devel-1.3.0-0.x86_64.rpm

   4. lightwave-post-1.3.0-0.x86_64.rpm

   5. lightwave-mutentca-1.3.0-0.x86_64.rpm

   6. lightwave-server-1.3.0-0.x86_64.rpm

デプロイ

Lightwave プラットフォームは、Lightwave ドメインコントローラと Lightwave ドメインクライアントで構成されます。

プリビルド済み Lightwave バイナリ

Lightwave のプリビルドバイナリは、Photon デプロイメントに設定できる以下の YUM リポジトリから入手できます。

以下の YUM リポジトリを設定すると、それぞれ "tdnf install vmware-lightwave-server" と "tdnf install vmware-lightwave-clients" を使用して Lightwave ドメインコントローラと Lightwave クライアントをインストールできるようになります。

注: 以下の YUM リポジトリを設定した後、photon-iso.repo を無効にしてください。これは /etc/yum.repos.d/photon-iso.repo で "enabled=0" を設定することで行います。

Lightwave YUM リポジトリ

以下の内容で "/etc/yum.repos.d/lightwave.repo" ファイルを作成します。

Photon 1.0 の場合

[lightwave]
name=VMware Lightwave 1.0(x86_64)
baseurl=https://dl.bintray.com/vmware/lightwave
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
gpgcheck=0
enabled=1
skip_if_unavailable=True

Photon 2.0 の場合

[lightwave]
name=VMware Lightwave for Photon 2.0(x86_64)
baseurl=https://vmware.bintray.com/lightwave-dev/photon_2.0/master
gpgcheck=0
enabled=1
skip_if_unavailable=True
EOM

Photon Extras YUM リポジトリ

以下の内容で "/etc/yum.repos.d/photon-extras.repo" ファイルを作成します。

Photon 1.0 の場合

[photon-extras]
name=VMware Photon Extras 1.0(x86_64)
baseurl=https://dl.bintray.com/vmware/photon_extras
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
gpgcheck=0
enabled=1
skip_if_unavailable=True

Photon 2.0 の場合

[photon-extras]
name=VMware Photon Extras 2.0(x86_64)
baseurl=https://dl.bintray.com/vmware/photon_extras_$releasever_$basearch
gpgkey=file:///etc/pki/rpm-gpg/VMWARE-RPM-GPG-KEY
gpgcheck=1
enabled=1
skip_if_unavailable=True

Lightwave ドメインコントローラのセットアップ

まず、Photon インスタンスに以下のパッケージをインストールする必要があります。

1. lightwave-client
2. lightwave-server
3. lightwave

これらをインストールするには、単純に以下の tdnf コマンドを実行します。

Photon 1.0 の場合

tdnf makecache
tdnf install lightwave-client lightwave lightwave-server

Photon 2.0 の場合

tdnf makecache
tdnf install lightwave-client-1.3.1 lightwave-1.3.1 lightwave-server-1.3.1

これにより、Lightwave に必要なすべての依存関係が取得されます。

ドメインコントローラのインスタンス化

インスタンスのホスト名を設定する

この手順は、すべての Lightwave ノードで必要です。/etc/hosts ファイルを以下のように編集します。 注 新しい PhotonOS インストールではデフォルトで設定されていない可能性があるため、変数は適切な値に置き換えてください。

echo -e "127.0.0.1\tlocalhost" > /etc/hosts
echo -e "${VM_IP}\t${VM_HOSTNAME}.${VM_DOMAIN_NAME} ${VM_HOSTNAME}" >> /etc/hosts
hostnamectl set-hostname --static ${VM_HOSTNAME}

VM_DOMAIN_NAME は最初のサーバーで選択でき、クラスタ内のすべてのパートナーノードで同じである必要があります。

スタンドアロンモード (これは新しいドメインの最初のレプリカです)

/opt/vmware/bin/configure-lightwave-server --password <password>

パートナーモード (これは既存のドメインに追加される新しいレプリカです)

/opt/vmware/bin/configure-lightwave-server --password <password> \
 --server <hostname or ip-address of partner instance>

注:

1. ドメイン管理者に指定するパスワードは、8文字以上で、大文字、小文字、数字、特殊文字を含む必要があります。

2. システムをドメインコントローラに昇格させる前に、静的 IP アドレスまたは予約付き DHCP アドレスをシステムに割り当ててください。

Lightwave ドメインクライアントのセットアップ

Photon システムを Lightwave ドメインに参加させるには、以下のパッケージが必要です。

1. lightwave-client-1.3.0-0.x86_64.rpm

プリビルドバイナリに YUM リポジトリを使用する場合は、"tdnf install vmware-lightwave-clients" を使用して Lightwave ドメインクライアントをインストールします。

システムを Lightwave ドメインに参加させる

/opt/vmware/bin/domainjoin join <domain hostname>

コントリビューション

新機能、修正、更新など、大小を問わずコントリビューションを歓迎します。プルリクエストをお待ちしており、できるだけ早く処理するよう努めます。コードのコントリビューションを希望され、コントリビューターライセンス契約 (CLA) に署名されていない場合、プルリクエスト を開くとボットが issue を更新します。CLA プロセスに関する質問は、FAQ を参照してください。

コードを書く前に、特に大規模なコントリビューションの場合は、GitHub issue を通じて計画を議論するか、#Lightwave Slack Channel で公式プロジェクトのメンテナと最初に話し合うことをお勧めします。これにより、他のコントリビューターが正しい方向性を示したり、設計についてフィードバックを提供したり、同じ作業を他の誰かが行っていないか確認したりする機会が得られます。

ライセンス

Lightwave は Apache 2 ライセンス の下で利用できます。