助けが必要? 私たちはここにいます!
お問い合わせいただきありがとうございます。弊社のチームがすぐにご連絡させていただきます。
24時間以内に連絡がない場合は、お気軽にフォローアップメールをお送りください。 info@xecurify.com
検索結果:
×[最新バージョン: 1.6.0] [リリースと機能アップデート]
miniOrange LDAP Gatewayは、オンプレミスのActive DirectoryまたはLDAPサーバーをminiOrangeクラウドIDプラットフォームに接続する軽量ブリッジです。イントラネット内(通常はDMZ)にインストールされ、miniOrangeへのアウトバウンド通信を行います。LDAPサーバーにパブリックIPアドレスは必要ありません。
このゲートウェイは、2つの異なるユースケースをサポートしています。
どちらのユースケースも、インストールと設定の手順は共通しています。このガイドでは、まず共通の手順を説明し、その後、ユースケース固有の手順へと進みます。

LDAPゲートウェイをインストールするサーバーの最小要件は以下のとおりです。
| 技術仕様 | 最小要件 |
|---|---|
| CPU | 2コア |
| RAM | 4 GB |
| ディスク | 30 GBの空き容量 |
| オペレーティングシステム | Windows Server 2008以降 | Linux(サポートされているディストリビューションについては下記を参照) |
| Java | ZIPファイルによる手動インストールの場合のみ必要です。その他のインストーラーにはJava 17が自動的に同梱されます。 |
サポートされているLinuxディストリビューション:
バージョン1.6.0以降では、ネイティブのDEBおよびRPMインストーラーが利用可能です。パッケージベースのデプロイメントでは、別途Javaをインストールする必要はありません。
インストール前に、以下のネットワークアクセスが設定されていることを確認してください。
| リーダーシップ | プロトコル/ポート | 目的 |
|---|---|---|
| 送信(ゲートウェイサーバーから) | TCP 443 → login.xecurify.com | ゲートウェイはminiOrangeクラウドへ外部通信を行う (ユーザー同期設定) |
| 送信(ゲートウェイサーバーから) | TCP 389 → AD/LDAPサーバー | 標準LDAP (ユーザー同期設定) |
| 送信(ゲートウェイサーバーから) | TCP 636 → AD/LDAPサーバー | セキュアLDAP(LDAPS)—LDAPSが構成されている場合のみ (ユーザー同期設定) |
| 受信(ゲートウェイサーバー宛) | TCP 8080(またはカスタムポート) | ゲートウェイのWeb UIおよびAPIへのHTTPアクセス。miniOrangeクラウドのIPアドレス(52.55.147.107、52.86.38.163、54.165.245.227)からアクセス可能である必要があります。 (ユーザー認証設定) |
| 受信(ゲートウェイサーバー宛) | TCP 443 | HTTPSアクセス(SSLが設定されている場合) (ユーザー認証設定) |
お使いのオペレーティングシステムに合ったインストーラーをダウンロードしてください。
| インストーラー(最新バージョン:1.6.0) | サポートされるOS | ダウンロード | SHA-256チェックサム |
|---|---|---|---|
| Windowsインストーラー(.exeファイル) | Windows Server 2008以降 | ダウンロード |
|
| Linux DEBパッケージ(.deb) | Ubuntu、Debian、Linux Mint | ダウンロード |
|
| Linux RPM (.rpm) | RHEL、Rocky Linux、AlmaLinux、CentOS、Fedora、openSUSE | ダウンロード |
|
| ZIP(手動) | WindowsとLinux - すべてのディストリビューション | ダウンロード |
|
x
選択したインストール方法の手順に従ってください。
注: WindowsインストーラーにはOpenLogic JDK 17が同梱されています。システムにJava 17が既にインストールされている場合、同梱されているJDKのインストールは自動的にスキップされます。
C:\Program Files\miniOrange LDAP Gateway注: DEBおよびRPMインストーラーにはOpenLogic JDK 17が同梱されています。システムへのJavaのインストールは不要です。
DEBインストーラー(.debファイル)は、Ubuntu、Debian、およびLinux Mintでサポートされています。
以下のコマンドを使用して、ダウンロードしたdebパッケージをインストールしてください。
sudo apt install -y ./miniorange-ldap-gateway.deb
RPMインストーラー(.rpm)は、RHEL、Rocky Linux、AlmaLinux、CentOS、Fedora、およびopenSUSEでサポートされています。ダウンロードしたrpmパッケージは、以下のコマンドを使用してインストールしてください。
sudo dnf install -y ./miniorange-ldap-gateway.rpm
インストール後、インストーラーはシステム上に以下のパスとファイルを設定します。
systemdサービス「miniorangegateway」は、起動時に自動的に登録および起動されます。以下のコマンドを使用して管理してください。
sudo systemctl start miniorangegateway
sudo systemctl stop miniorangegateway
sudo systemctl restart miniorangegateway
sudo systemctl status miniorangegateway
この方法は、DEB/RPMでサポートされていないLinuxディストリビューションを含む、あらゆるWindowsまたはLinuxシステムで使用できます。
重要:このZIPパッケージにはJavaは含まれていません。先に進むにはJava 17をインストールする必要があります。それ以前のバージョンはサポートされていません。
Java 17のインストール方法(ZIPファイルのみ)
ゲートウェイの抽出と設定
miniorangegateway-<version> (例えば miniorangegateway-1.5.0).miniorangegateway-<version> フォルダを次の場所に移動します:C:\Program Files\miniOrange LDAP Gateway\/opt/miniorangegateway/ゲートウェイはデフォルトでポート8080で動作します。ポートを変更するには、手順1.2(オプション)を参照してください。
ゲートウェイをシステムサービスとして設定する(ZIP方式のみ)
Windowsの場合:
sc create "miniOrangeGateway" binPath= "cmd.exe /c \"C:\Program Files\miniOrange LDAP Gateway\bin\catalina.bat start\"" start= auto DisplayName= "miniOrange LDAP Gateway"
sc start miniOrangeGateway
sc query miniOrangeGateway
sc stop miniOrangeGateway
Linux (systemd) の場合:
sudo vi /etc/systemd/system/miniorangegateway.service
JAVA_HOME Javaのインストール場所に一致するパスを指定してください。 [Unit]
Description=miniOrange LDAP Gateway
After=syslog.target network.target
[Service]
Type=forking
Environment=JAVA_HOME= # e.g. /usr/lib/jvm/jre
Environment=CATALINA_PID=/opt/miniorangegateway/temp/gateway.pid
Environment=CATALINA_HOME=/opt/miniorangegateway
Environment=CATALINA_BASE=/opt/miniorangegateway
Environment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC'
Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
ExecStart=/opt/miniorangegateway/bin/startup.sh
ExecStop=/bin/kill -15 $MAINPID
User=miniorange
Group=miniorange
UMask=0007
RestartSec=10
Restart=always
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable miniorangegateway
sudo systemctl start miniorangegateway
デフォルトでは、ゲートウェイはポート8080で動作します。変更するには:

ポート変更後、ゲートウェイには次のURLでアクセスできます:http://<server-ip>:<new-port>/miniorangegateway/
http://<server-ip>:8080/miniorangegateway/
注:手順1.2でカスタムポートを設定した場合は、8080の代わりにそのポートを使用してください。

この手順では、ゲートウェイとオンプレミスのAD/LDAPサーバー間の接続を設定します。



| フィールド | 詳細説明 | 例: |
|---|---|---|
| 構成識別子 | このLDAP設定に固有の名前を付けてください。 | MyCompany-AD |
| LDAPサーバーのURL | LDAPサーバーのホスト名とポート番号。 | ldap://myldapserver.domain:389 |
| アカウントDNのバインド | LDAPへの接続に使用するアカウント。UPNまたはDN形式を使用してください。 | admin@domain.com または CN=admin,DC=domain,DC=com |
| アカウントのパスワードをバインドする | アカウントをバインドするためのパスワード。 | - |
| 検索ベース | ユーザーを検索する組織単位(OU)の識別名。 | CN=ユーザー、DC=ドメイン、DC=com |
| 検索フィルター | ユーザーオブジェクトを識別するためのLDAPフィルタ。グループベースのフィルタを使用する場合は、グループDNと共に。 | (objectClass=user) |
| ドメイン名 | セミコロンで区切られたドメイン名のリスト。 | company.com;subsidiary.com |
| 名属性 | LDAP属性が名にマッピングされました。 | 名 |
| 姓属性 | LDAP属性が姓にマッピングされました。 | sn |
| 電子メールの属性 | LDAP属性がメールアドレスにマッピングされました。 | |
| ユーザー名の属性 | LDAP属性がユーザー名にマッピングされます。 | sAMアカウント名 |
| 電話属性 | LDAP属性が電話番号にマッピングされました。 | 電話番号 |
| ユーザーグループ属性 | グループメンバーシップを表すLDAP属性。 | メンバーの |
| グループの検索ベース | グループを検索するOUのDN。 | CN=グループ、DC=ドメイン、DC=com |
| グループ検索フィルター | グループオブジェクトを識別するためのLDAPフィルタ。 | (&(objectCategory=group)(!(cn=admin*))) |
| グループ名属性 | グループ名を表すLDAP属性。 | sAMアカウント名 |
| LDAP 属性リスト | セミコロンで区切られた、取得する追加属性のリスト。 | cn;メール;名 |
| IdP ユーザー プロファイル フィールドのマッピング | LDAP属性をminiOrangeユーザープロファイルフィールドにマッピングします。 | [必要に応じて設定してください] |
| 同期の設定を有効にする | スケジュールされた同期のためのこの接続を有効または無効にします。 | ユーザー同期ユースケースを使用する場合は有効にしてください。 |


ゲートウェイの設定が完了しました。続行するには、ユースケースを選択してください。
ユーザー同期(AD/LDAPからminiOrangeへのユーザー同期):以下のパート2.1に進んでください。ユーザー認証(miniOrangeを介してAD/LDAPに対してユーザーを認証):パート2.2に進んでください。
AD/LDAPディレクトリからminiOrangeクラウドにユーザーとグループを同期することが目的の場合は、このセクションを使用してください。同期の設定とトリガーはすべてゲートウェイのWeb UI内で行われ、miniOrangeクラウドコンソールで追加の手順は必要ありません。
| フィールド | 詳細説明 |
|---|---|
| グループ同期を有効にする | Active DirectoryからminiOrangeへのグループ同期を有効にします。 |
| ユーザー同期を有効にする | Active DirectoryからminiOrangeへのユーザーアカウントの同期を有効にします。 |
| ユーザーグループメンバーシップの同期を有効にする | グループメンバーシップの割り当てを同期するには、このオプションを有効にしてください。注:グループ同期が無効になっているにもかかわらず、このオプションが有効になっている場合、miniOrange ではユーザーのすべてのグループ割り当てが削除されます。 |
| ネストされたグループのインポートを有効にする | Active DirectoryからminiOrangeへネストされたグループをインポートおよび同期できるようにします。子グループのメンバーであるユーザーは、同期時に親グループからメンバーシップを継承します。 |
| ユーザー同期から除外するグループ | 有効にすると、選択したグループに属するユーザーは常にそのグループのメンバーであり続けます。LDAPユーザー同期中に、これらのグループのグループ割り当て解除は行われません。 |
| 削除ユーザー同期を有効にする | ディレクトリからユーザーが削除された際に、miniOrangeからもユーザーを削除する機能を有効にします。使用には注意が必要です。有効にする前に、除外リストを設定してください。 |
| 除外リストの設定 | 削除同期から除外する特定のユーザーを選択します。管理者アカウントを保護するために推奨されます。 |
| 同期の有効/無効状態 | 有効にすると、Active Directory におけるユーザーの有効化/無効化ステータスの変更は、ユーザー同期時に miniOrange に同期されます。 |
| 同期ロック/ロック解除状態 | 有効にすると、Active Directory におけるユーザーアカウントのロック/ロック解除ステータスの変更が、ユーザー同期時に miniOrange に同期されます。 |
| 開始時刻(hh:mm) | 最初の同期をスケジュールする時刻。現在のサーバー時刻より前の時刻を指定すると、即座に同期が実行されます。 |
| 同期間隔(時間単位) | 初回実行後、スケジュールされた同期が繰り返される頻度。 |

重要: LDAP接続設定(手順1)にある「同期構成を有効にする」トグルスイッチは、特定のディレクトリ接続を同期スケジュールに含めるかどうかを制御します。同期したいすべての接続で、このトグルスイッチが有効になっていることを確認してください。


ユーザー同期の設定が完了しました.
AD/LDAPディレクトリのユーザーとグループは、設定したスケジュールに従ってminiOrangeに同期されます。このユースケースでは、miniOrangeクラウドコンソールでの追加設定は不要です。
miniOrangeがゲートウェイ経由でオンプレミスのAD/LDAPに対してユーザー認証を行うことが目的の場合は、このセクションを使用してください。これには、miniOrangeクラウドコンソールで追加の設定手順が1つ必要になります。
この手順では、miniOrangeがゲートウェイの場所を特定し、認証要求をAD/LDAPサーバーに転送できるようにします。



ユーザー認証の設定が完了しました。.
miniOrangeは、ゲートウェイを介してオンプレミスのAD/LDAPに対してユーザー認証を行うようになります。
AD/LDAPサーバーが標準LDAP(ポート389)ではなくセキュアLDAP(ポート636)を使用している場合は、これを構成してください。
重要:この手順を実行するには、ゲートウェイが管理者/root権限で実行されている必要があります。
| フィールド | 詳細説明 | 例: |
|---|---|---|
| 主催者 | LDAPドメインコントローラーのホスト名。 | ldap.company.com |
| ポート | セキュアなLDAPポート。 | 636 |
| エイリアス | Java TrustStoreに証明書を保存するために使用される名前。 | myldap証明書 |
| パスワード | Java TrustStoreのパスワード。 | 変更する(デフォルト) |

デフォルトでは、ゲートウェイのWeb UIはHTTPで動作します。セキュリティ要件でHTTPSが必要な場合は、HTTPSを設定してください。開始する前に、どちらが該当するかを確認してください。
自己署名証明書を生成する(認証局証明書をお持ちの場合はスキップしてください)
<JAVA_HOME>/bin/ ディレクトリを作成し、 certs/ サブディレクトリ。 keytool -genkey -alias <ALIAS> -keyalg RSA -keystore <JAVA_HOME>/bin/certs/keystore.jks
server.xmlでHTTPSコネクタを設定します。
conf/ ゲートウェイのインストールディレクトリ内のディレクトリ:/opt/miniorangegateway/conf/C:\Program Files\miniOrange LDAP Gateway\conf\
server.xml そして、以下のコネクタ要素を内部に追加します。 <Service name="Catalina">: <Connector
port="443"
protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true"
maxThreads="150"
scheme="https"
secure="true">
<SSLHostConfig hostName="_default_">
<Protocols>
TLSv1.2,TLSv1.3
</Protocols>
<Certificate
certificateKeystoreFile="<JAVA_HOME>/bin/certs/keystore.jks"
certificateKeystorePassword="<KEYSTORE_PASSWORD>"
certificateKeyAlias="<ALIAS>"
type="RSA"
/>
</SSLHostConfig>
</Connector>
サーバーにホスト名を割り当てる
C:\Windows\System32\drivers\etc\hosts
/etc/hosts 127.0.0.1 <newhostname>
<Engine name="Catalina" defaultHost="localhost"> localhost を <newhostname>.<Host> 要素と置換 name="localhost" name="<IP Address or DNS>".重要: HTTPS を設定した後、miniOrange クラウド コンソール(パート 2、ステップ 2.2)でゲートウェイ URL を更新して、http://の代わりにhttps:// を使用するようにしてください。
インストール方法に応じた手順に従ってください。
インストーラーはアップグレードを自動的に処理し、設定を保持します。
# Linux: sudo systemctl stop miniorangegateway
# Windows: stop the service via services.msc
# Linux: sudo systemctl start miniorangegateway
重要: SSL 設定 (server.xml) はアップグレード後に自動的に復元されません。インストーラーは既存の server.xml をバックアップし、 /var/backups/miniorangegateway/server.xml (Linuxの場合)置き換える前に、必ず変更してください。SSLが設定されている場合は、アップグレード後にserver.xmlのSSL設定を手動で再適用してください。
更新内容に応じてアップグレードの種類を選択してください。
オプションA — ゲートウェイアプリケーションのみをアップグレードする
webapps/miniorangegateway/ フォルダにコピーします。webapps/miniorangegateway/ そのフォルダをインストール先にコピーして、既存のフォルダを上書きしてください。application.properties 以下に送って下さい:/opt/miniorangegateway/webapps/miniorangegateway/WEB-INF/classes/application.propertiesC:\Program Files\miniOrange LDAP Gateway\webapps\miniorangegateway\WEB-INF\classes\application.propertiesオプションB — インストール全体をアップグレードする(ゲートウェイ+Tomcat)
application.properties (上記と同じ経路)conf/server.xml — ただし、変更を加えた場合のみ(例:SSL設定、カスタムポート)/opt/miniorangegateway/C:\Program Files\miniOrange LDAP Gateway\application.properties 以下に送って下さい:/opt/miniorangegateway/webapps/miniorangegateway/WEB-INF/classes/application.propertiesC:\Program Files\miniOrange LDAP Gateway\webapps\miniorangegateway\WEB-INF\classes\application.propertiesJava 17が必要です。それ以前または以降のバージョンはサポートされていません。注:Windows、DEB、およびRPMインストーラーにはOpenLogic JDK 17が自動的にバンドルされています。ZIP方式を使用する場合のみ、Javaを手動でインストールする必要があります。
はい、ゲートウェイを正しくデプロイして機能させるには、Tomcat 11以降が必要です。WindowsおよびLinuxインストーラーには、適切なバージョンのTomcatが同梱されています。
デフォルトでは、ゲートウェイは設定済みのAD属性が変更された場合にのみminiOrangeに更新情報を送信します。すべてのユーザーの更新情報をすべての同期時に送信するには、application.propertiesファイルに以下を設定してください。
Force update all users on every sync: send.force.updates=true
# Default (only update on change): send.force.updates=false
グループ同期が無効になっているにもかかわらず、ユーザーグループメンバーシップ同期が有効になっている場合、ゲートウェイはminiOrange内のユーザーからすべてのグループ割り当てを削除します。miniOrangeでのグループ変更を防止するには、ユーザーグループメンバーシップ同期も無効にしてください。