Oracle Unified Directoryの管理REST API: DNによるプロキシLDAPワークフロー要素の検索

DNによるプロキシLDAPワークフロー要素の検索

GET

/rest/v1/admin/{dn}

DNによってプロキシLDAPワークフロー要素を返します

リクエスト

サポートされているメディア・タイプ

application/json

パス・パラメータ

dn: string

フェッチするエントリのLDAP DN。

問合せパラメータ

attributes: array

コレクション形式: multi

エントリに対してフェッチする属性のリスト。

[0]: string

{
    "name":"attributes",
    "in":"query",
    "description":"List of attributes to be fetched for the entry.",
    "type":"array",
    "collectionFormat":"multi",
    "items":{
        "type":"string"
    }
}

controls: array

コレクション形式: multi

検索操作のためにサーバーに送信するLDAP制御。

[0]: string

{
    "name":"controls",
    "in":"query",
    "description":"LDAP controls to be sent to server for search operation.",
    "type":"array",
    "collectionFormat":"multi",
    "items":{
        "type":"string"
    }
}

filter: string

LDAP検索操作用の検索フィルタ。LDAP検索フィルタの構文に従う必要があります。
scope: string

LDAP検索操作の範囲。

指定可能な値: [ "base", "sub", "one" ]

先頭に戻る

レスポンス

サポートされているメディア・タイプ

application/json

200レスポンス

ルート・スキーマ: プロキシLDAPワークフロー要素のGetSuccessResponse

型: object

ソースを表示

msgType: string

デフォルト値: urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse

RESTメッセージ・タイプ
searchResultEntries: array searchResultEntries

LDAP操作後に返される検索結果エントリの数。
totalResults: integer(int32)

作成され、返されるエントリの数を指定します。

{
    "type":"object",
    "required":[
        "msgType",
        "totalResults",
        "searchResultEntries"
    ],
    "properties":{
        "msgType":{
            "description":"The REST message type",
            "default":"urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse",
            "type":"string"
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the number of entries created, and returned."
        },
        "searchResultEntries":{
            "type":"array",
            "description":"Number of search result entries returned after the LDAP operation.",
            "items":{
                "$ref":"#/definitions/Proxy LDAP Workflow Element SearchResultEntry"
            }
        }
    }
}

ネストされたスキーマ: searchResultEntries

型: array

LDAP操作後に返される検索結果エントリの数。

ソースを表示

[0]: object プロキシLDAPワークフロー要素のSearchResultEntry

{
    "type":"array",
    "description":"Number of search result entries returned after the LDAP operation.",
    "items":{
        "$ref":"#/definitions/Proxy LDAP Workflow Element SearchResultEntry"
    }
}

ネストされたスキーマ: プロキシLDAPワークフロー要素のSearchResultEntry

型: object

ソースを表示

attributes: object プロキシLDAPワークフロー要素のプロパティ
dn: string

作成するエントリのLDAP DN。

{
    "type":"object",
    "required":[
        "dn",
        "attributes"
    ],
    "properties":{
        "dn":{
            "description":"LDAP DN of the entry to be created",
            "type":"string"
        },
        "attributes":{
            "$ref":"#/definitions/Proxy LDAP Workflow Element Properties"
        }
    }
}

ネストされたスキーマ: プロキシLDAPワークフロー要素のプロパティ

型: object

ソースを表示

cn(optional): string

エントリのCN (共通名)
ds-cfg-client-cred-mode: string

指定可能な値: [ "use-client-identity", "use-proxy-auth", "use-specific-identity" ]

プロキシ・サーバーがリモートLDAPサーバーにバインドする方法を指定します。
ds-cfg-enabled: boolean

サーバーでワークフロー要素が使用可能かどうかを示します。
ds-cfg-exclude-list(optional): array ds-cfg-exclude-list

このリストには一連のDNが含まれています。クライアント・バインドDNが除外リスト上のいずれかのDNの子である場合、包含リストの内容に関係なく、リモート・サーバーに対する認証はプロキシ資格証明を使用して実行されます。
ds-cfg-include-list(optional): array ds-cfg-include-list

このリストには一連のDNが含まれています。クライアント・バインドDNがリスト上のいずれかのDNの子である場合、またはリストが空である場合、リモート・サーバーに対する認証を実行するためにクライアント資格証明を使用できます(クライアント・バインドDNが除外リスト上のいずれかのDNの子である場合を除きます)。never-bindフラグが無効になっている場合は、認証に対してサイレント・バインドが実行されます。never-bindフラグが有効になっている場合は、ユーザーのエントリがリモート・サーバーから取得され、資格証明がローカルでチェックされます。
ds-cfg-java-class: string

デフォルト値: com.sun.dps.server.workflowelement.proxyldap.ProxyLdapWorkflowElement

プロキシLDAPワークフロー要素の実装を提供するJavaクラスの完全修飾名を指定します。
ds-cfg-ldap-server-extension: string

このプロキシLDAPワークフロー要素に対して構成されたLDAPサーバー拡張機能を識別します。
ds-cfg-log-silent-bind-response-controls(optional): boolean

デフォルト値: false

サイレント・バインドのレスポンス制御のロギングが有効であるかどうかを示します。
ds-cfg-never-bind(optional): boolean

デフォルト値: false

never-bindフラグが有効であるかどうかを示します。
ds-cfg-never-bind-user-password-attribute(optional): string

デフォルト値: userPassword

この属性は、リモート・サーバー上のユーザーの資格証明を識別する属性の説明を定義します。never-bindフラグが有効になっている場合にのみ関係します。この属性が省略されている場合、デフォルト値userPasswordがかわりに使用されます。
ds-cfg-remote-ldap-server-bind-dn(optional): string

リモート・サーバーへの接続に使用されるDN。このDNはリモート・サーバー上に存在している必要があります。
ds-cfg-remote-ldap-server-bind-password(optional): string

リモート・サーバーへの接続に使用されるパスワード。
ds-cfg-remote-ldap-server-bind-password-file(optional): string

リモート・サーバーへの接続に使用されるパスワードを含むファイル。
ds-cfg-remote-root-dn(optional): string

リモート・サーバーでの内部操作の実行に使用されるルートDN。このDNはリモート・サーバー上に存在している必要があります。値""は、匿名の資格証明を示します。""が指定された場合、remote-ldap-server-bind-passwordプロパティは無視されます。
ds-cfg-remote-root-password(optional): string

リモート・サーバーに接続するためにルートDNで使用されるパスワード。
ds-cfg-use-proxy-auth(optional): boolean

デフォルト値: false

このフラグは、LDAPコネクタがプロキシ認可制御を使用できるかどうかを示します。
objectclass: array objectclass

このエントリが属するオブジェクト・クラス。

{
    "type":"object",
    "required":[
        "objectclass",
        "ds-cfg-java-class",
        "ds-cfg-client-cred-mode",
        "ds-cfg-ldap-server-extension",
        "ds-cfg-enabled"
    ],
    "properties":{
        "objectclass":{
            "type":"array",
            "description":"Objectclass(es) which this entry belongs to.",
            "items":{
                "type":"string"
            }
        },
        "cn":{
            "type":"string",
            "description":"CN (common name) of the entry"
        },
        "ds-cfg-java-class":{
            "description":"Specifies the fully-qualified name of the Java class that provides the Proxy LDAP Workflow Element implementation. ",
            "readOnly":false,
            "default":"com.sun.dps.server.workflowelement.proxyldap.ProxyLdapWorkflowElement",
            "type":"string"
        },
        "ds-cfg-remote-ldap-server-bind-dn":{
            "description":"DN which will be used to connect to a remote server. This DN must exist on the remote server. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-never-bind":{
            "description":"Indicates whether the never-bind flag is enabled. ",
            "readOnly":false,
            "default":false,
            "type":"boolean"
        },
        "ds-cfg-never-bind-user-password-attribute":{
            "description":"This attribute defines the description of the attribute that identifies the user's credentials on the remote server. It is relevant only when the never-bind flag is enabled. When this attribute is omitted the default value \"userPassword\" is used instead. ",
            "readOnly":false,
            "default":"userPassword",
            "type":"string"
        },
        "ds-cfg-use-proxy-auth":{
            "description":"This flag indicates whether the LDAP connector can use the proxy authorization control. ",
            "readOnly":false,
            "default":false,
            "type":"boolean"
        },
        "ds-cfg-include-list":{
            "description":"The list contains a set of DNs. If the client bind DN is a descendant of one of the DNs in the list, or if the list is empty, then the client credentials can be used to perform authentication against the remote server (as long as the client bind DN is not a descendant of any DN on the exclude list). If the never-bind flag is disabled then a silent-bind is performed for the authentication. If the never-bind flag is enabled, the user's entry is retrieved from the remote server and the credentials are checked locally. ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "ds-cfg-client-cred-mode":{
            "description":"Specifies the way the proxy server binds to the remote LDAP server. ",
            "readOnly":false,
            "type":"string",
            "enum":[
                "use-client-identity",
                "use-proxy-auth",
                "use-specific-identity"
            ]
        },
        "ds-cfg-remote-ldap-server-bind-password-file":{
            "description":"File which contains the password which will be used to connect to the remote server. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-remote-ldap-server-bind-password":{
            "description":"Password which will be used to connect to the remote server. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-remote-root-password":{
            "description":"Password which will be used by the root DN to connect to the remote server. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-ldap-server-extension":{
            "description":"Identifies the LDAP server extension configured for this Proxy LDAP Workflow Element. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-enabled":{
            "description":"Indicates whether the Workflow Element is enabled for use in the server. ",
            "readOnly":false,
            "type":"boolean"
        },
        "ds-cfg-remote-root-dn":{
            "description":"The root DN which will be used to perform internal operations on a remote server. This DN must exist on the remote server. The value \"\" denotes the anonymous credentials. If \"\" is provided then the remote-ldap-server-bind-password property is ignored. ",
            "readOnly":false,
            "type":"string"
        },
        "ds-cfg-log-silent-bind-response-controls":{
            "description":"Indicates whether the logging of the silent-bind response controls is enabled. ",
            "readOnly":false,
            "default":false,
            "type":"boolean"
        },
        "ds-cfg-exclude-list":{
            "description":"The list contains a set of DNs. If the client bind DN is a descendant of one DNs on the exclude list, then the authentication against the remote server will be performed using the proxy credentials, regardless of the content of the include list. ",
            "readOnly":false,
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストされたスキーマ: ds-cfg-exclude-list

型: array

このリストには一連のDNが含まれています。クライアント・バインドDNが除外リスト上のいずれかのDNの子である場合、包含リストの内容に関係なく、リモート・サーバーに対する認証はプロキシ資格証明を使用して実行されます。

ソースを表示

[0]: string

{
    "description":"The list contains a set of DNs. If the client bind DN is a descendant of one DNs on the exclude list, then the authentication against the remote server will be performed using the proxy credentials, regardless of the content of the include list. ",
    "readOnly":false,
    "type":"array",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: ds-cfg-include-list

型: array

このリストには一連のDNが含まれています。クライアント・バインドDNがリスト上のいずれかのDNの子である場合、またはリストが空である場合、リモート・サーバーに対する認証を実行するためにクライアント資格証明を使用できます(クライアント・バインドDNが除外リスト上のいずれかのDNの子である場合を除きます)。never-bindフラグが無効になっている場合は、認証に対してサイレント・バインドが実行されます。never-bindフラグが有効になっている場合は、ユーザーのエントリがリモート・サーバーから取得され、資格証明がローカルでチェックされます。

ソースを表示

[0]: string

{
    "description":"The list contains a set of DNs. If the client bind DN is a descendant of one of the DNs in the list, or if the list is empty, then the client credentials can be used to perform authentication against the remote server (as long as the client bind DN is not a descendant of any DN on the exclude list). If the never-bind flag is disabled then a silent-bind is performed for the authentication. If the never-bind flag is enabled, the user's entry is retrieved from the remote server and the credentials are checked locally. ",
    "readOnly":false,
    "type":"array",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: objectclass

型: array

このエントリが属するオブジェクト・クラス。

ソースを表示

[0]: string

{
    "type":"array",
    "description":"Objectclass(es) which this entry belongs to.",
    "items":{
        "type":"string"
    }
}

406レスポンス

受入れできません

ルート・スキーマ: ErrorResponse

型: object

ソースを表示

ldapErrorCode(optional): integer(int32)

操作に対して返されるLDAPエラー・コードを指定します。
message: string

操作に対して返されるエラー・メッセージ。
msgType: string

デフォルト値: urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponse

RESTメッセージ・タイプ

{
    "type":"object",
    "required":[
        "msgType",
        "message"
    ],
    "properties":{
        "msgType":{
            "description":"The REST message type",
            "default":"urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponse",
            "type":"string"
        },
        "message":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "ldapErrorCode":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the LDAP error code returned for the operation."
        }
    }
}

先頭に戻る