2021-11-22 20:02:30 +00:00
---
2022-05-09 19:22:41 +00:00
title: PowerDNS-Admin
2021-11-22 20:02:30 +00:00
---
2022-06-15 19:31:34 +00:00
< span class = "badge badge--secondary" > Support level: Community< / span >
2021-11-22 20:02:30 +00:00
## What is PowerDNS-Admin
2023-07-31 10:16:58 +00:00
> A PowerDNS web interface with advanced features.
>
> -- https://github.com/ngoduykhanh/PowerDNS-Admin
2021-11-22 20:02:30 +00:00
## Preparation
The following placeholders will be used:
2022-05-09 19:22:41 +00:00
- `pdns-admin.company` is the FQDN of the PowerDNS-Admin install.
- `authentik.company` is the FQDN of the authentik install.
2021-11-22 20:02:30 +00:00
Create a SAML provider with the following parameters:
2022-05-09 19:22:41 +00:00
- ACS URL: `https://pdns-admin.company/saml/authorized`
- Issuer: `https://authentik.company`
- Service Provider Binding: `Post`
- Audience: `pdns-admin`
- Signing Keypair: Select any certificate you have.
- Property mappings: Select all Managed mappings.
2021-11-22 20:02:30 +00:00
You can of course use a custom signing certificate, and adjust durations.
## PowerDNS-Admin
You need to set the following `env` Variables for Docker based installations.
Set the following values:
```env
SAML_ENABLED=True
SAML_PATH=os.path.join(os.path.dirname(file), 'saml')
2023-01-04 18:45:31 +00:00
SAML_METADATA_URL=https://authentik.company/application/saml/< application-slug > /metadata/
2021-11-22 20:02:30 +00:00
SAML_METADATA_CACHE_LIFETIME=1
2023-01-04 18:45:31 +00:00
SAML_LOGOUT_URL=https://authentik.company/application/saml/< application-slug > /slo/binding/redirect/
2021-11-22 20:02:30 +00:00
SAML_SP_ENTITY_ID=pdns-admin
SAML_SP_CONTACT_NAME=me
SAML_SP_CONTACT_MAIL=me
SAML_NAMEID_FORMAT=urn:oasis:names:tc:SAML:2.0:nameid-format:persistent
SAML_ATTRIBUTE_USERNAME=http://schemas.goauthentik.io/2021/02/saml/username
SAML_ATTRIBUTE_NAME=http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
SAML_ATTRIBUTE_EMAIL=http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
SAML_ATTRIBUTE_GROUP=http://schemas.xmlsoap.org/claims/Group
SAML_GROUP_ADMIN_NAME=< admin-group-name >
SAML_SIGN_REQUEST='False'
SAML_ASSERTION_ENCRYPTED=False
SAML_WANT_MESSAGE_SIGNED=False
SAML_CERT=/saml.crt
```
You must mount the certificate selected in authentik as a file in the Docker container. The path in the container must match the path in the env variable `SAML_CERT` .
### docker-compose
2022-05-09 19:22:41 +00:00
2021-11-22 20:02:30 +00:00
```yaml
2022-05-09 19:22:41 +00:00
version: "3.3"
2021-11-22 20:02:30 +00:00
services:
2022-05-09 19:22:41 +00:00
powerdns-admin:
2023-10-10 10:59:57 +00:00
image: powerdnsadmin/pda-legacy:latest
2022-05-09 19:22:41 +00:00
restart: always
ports:
- 80:80
volumes:
- ./saml.crt:/saml.crt:ro
```