coredns-ldap/README.md
2021-02-09 16:23:20 +01:00

1.7 KiB

ldap

Name

ldap - serves a zone from a ldap backend.

Description

The ldap plugin resolves A, AAAA y PTR RR from a ldap backend. To reduce load on the backend, you can enable cache by configuring cacheTimeout=30m.

Compilation

This package will always be compiled as part of CoreDNS and not in a standalone way. It will require you to use go get or as a dependency on plugin.cfg.

The manual will have more information about how to configure and extend the server with external plugins.

A simple way to consume this plugin, is by adding the following on plugin.cfg, and recompile it as detailed on coredns.io.

ldap:github.com/xoe-labs/coredns-ldap

After this you can compile coredns by:

go generate
go build

Or you can instead use make:

make

Syntax

ldap

Metrics

If monitoring is enabled (via the prometheus directive) the following metric is exported:

  • coredns_ldap_request_count_total{server} - query count to the ldap plugin.

The server label indicated which server handled the request, see the metrics plugin for details.

Ready

This plugin reports readiness to the ready plugin. It will be immediately ready.

Examples

In this configuration, we forward all queries to 9.9.9.9 and print "ldap" whenever we receive a query.

. {
  forward . 9.9.9.9
  ldap
}

Also See

See the manual.