1. Le script d'installation DNS crée un fichier de configuration /etc/NetworkManager/conf.d/zzz-ipa.conf NetworkManager pour contrôler l'ordre de recherche et la liste des serveurs DNS :

   # auto-generated by IPA installer
   [main]
   dns=default
   
   [global-dns]
   searches=$DOMAIN
   
   [global-dns-domain-*]
   servers=127.0.0.1

2. Le service NetworkManager est rechargé, ce qui crée toujours le fichier /etc/resolv.conf avec les paramètres du dernier fichier du répertoire /etc/NetworkManager/conf.d/. Dans le cas présent, il s'agit du fichier zzz-ipa.conf.

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-presence-of-a-global-forwarder.yml

4. Ouvrez le fichier ensure-presence-of-a-global-forwarder.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the presence of a global forwarder in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure the presence of a DNS global forwarder to 7.7.9.9 and 2001:db8::1:0 on port 53.

   3. Dans la section forwarders de la partie ipadnsconfig:

      1. Remplacez la première valeur de ip_address par l'adresse IPv4 du transitaire global : 7.7.9.9.
      2. Remplacer la deuxième valeur ip_address par l'adresse IPv6 du transitaire global : 2001:db8::1:0.
      3. Vérifiez que la valeur port est définie sur 53.

   4. Modifier le state en present.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the presence of a global forwarder in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the presence of a DNS global forwarder to 7.7.9.9 and 2001:db8::1:0 on port 53
       ipadnsconfig:
         forwarders:
           - ip_address: 7.7.9.9
           - ip_address: 2001:db8::1:0
             port: 53
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-presence-of-a-global-forwarder.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-absence-of-a-global-forwarder.yml

4. Ouvrez le fichier ensure-absence-of-a-global-forwarder.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the absence of a global forwarder in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure the absence of a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800 on port 53.

   3. Dans la section forwarders de la partie ipadnsconfig:

      1. Remplacez la première valeur de ip_address par l'adresse IPv4 du transitaire global : 8.8.6.6.
      2. Remplacer la deuxième valeur ip_address par l'adresse IPv6 du transitaire global : 2001:4860:4860::8800.
      3. Vérifiez que la valeur port est définie sur 53.
   4. Fixer la variable action à member.
   5. Vérifiez que state est défini sur absent.

   Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the absence of a global forwarder in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the absence of a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800 on port 53
       ipadnsconfig:
         forwarders:
           - ip_address: 8.8.6.6
           - ip_address: 2001:4860:4860::8800
             port: 53
         action: member
         state: absent

   Important

   Si vous n'utilisez que l'option state: absent dans votre séquence sans utiliser également action: member, la séquence échoue.

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-absence-of-a-global-forwarder.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier set-configuration.yml Ansible playbook. Par exemple :

   $ cp set-configuration.yml set-forward-policy-to-first.yml

4. Ouvrez le fichier set-forward-policy-to-first.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsconfig task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.

   • Fixer la variable forward_policy à first.

     Supprimez toutes les autres lignes du playbook original qui ne sont pas pertinentes. Voici le fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to set global forwarding policy to first
     hosts: ipaserver
     become: true
   
     tasks:
     - name: Set global forwarding policy to first.
       ipadnsconfig:
         ipaadmin_password: "{{ ipaadmin_password }}"
         forward_policy: first

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file set-forward-policy-to-first.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier disable-global-forwarders.yml Ansible playbook. Par exemple :

   $ cp disable-global-forwarders.yml disable-global-forwarders-copy.yml

4. Ouvrez le fichier disable-global-forwarders-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsconfig task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.

   • Fixer la variable forward_policy à none.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to disable global DNS forwarders
     hosts: ipaserver
     become: true
   
     tasks:
     - name: Disable global forwarders.
       ipadnsconfig:
         ipaadmin_password: "{{ ipaadmin_password }}"
         forward_policy: none

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file disable-global-forwarders-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier disallow-reverse-sync.yml Ansible playbook. Par exemple :

   $ cp disallow-reverse-sync.yml disallow-reverse-sync-copy.yml

4. Ouvrez le fichier disallow-reverse-sync-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsconfig task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.

   • Fixer la variable allow_sync_ptr à no.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to disallow reverse record synchronization
     hosts: ipaserver
     become: true
   
     tasks:
     - name: Disallow reverse record synchronization.
       ipadnsconfig:
         ipaadmin_password: "{{ ipaadmin_password }}"
         allow_sync_ptr: no

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file disallow-reverse-sync-copy.yml

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.

   Figure 2.1. Gestion des zones primaires DNS de l'IdM

   
2. Cliquez sur Ajouter en haut de la liste de toutes les zones.

3. Indiquez le nom de la zone.

   Figure 2.2. Entrer dans une nouvelle zone primaire IdM

   
4. Click Add.

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.

2. Cochez la case correspondant au nom de la zone et cliquez sur Supprimer.

   Figure 2.3. Suppression d'une zone DNS primaire

   
3. Dans la fenêtre de dialogue Remove DNS zones, confirmez que vous souhaitez supprimer la zone sélectionnée.

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.

   Figure 2.4. Gestion des zones primaires DNS

   

2. Dans la section DNS Zones, cliquez sur le nom de la zone dans la liste de toutes les zones pour ouvrir la page de la zone DNS.

   Figure 2.5. Modification d'une zone primaire

   

3. Cliquez sur Settings.

   Figure 2.6. L'onglet Paramètres de la page d'édition de la zone primaire

   

4. Modifiez la configuration de la zone si nécessaire.

   Pour plus d'informations sur les paramètres disponibles, voir Attributs de la zone DNS IdM.

5. Cliquez sur Enregistrer pour confirmer la nouvelle configuration.

   Note

   Si vous modifiez la durée de vie (TTL) par défaut d'une zone, redémarrez le service named-pkcs11 sur tous les serveurs DNS IdM pour que les modifications soient prises en compte. Tous les autres paramètres sont automatiquement activés immédiatement.

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.
2. Cliquez sur Settings.

3. Sous Allow transfer, indiquez les serveurs de noms vers lesquels vous souhaitez transférer les enregistrements de zone.

   Figure 2.7. Permettre les transferts de zones

   
4. Cliquez sur Enregistrer en haut de la page de la zone DNS pour confirmer la nouvelle configuration.

Verification steps

1. SSH à l'un des serveurs DNS pour lesquels le transfert de zone a été activé :

   $ ssh 192.0.2.1

2. Transférer la zone DNS IdM à l'aide d'un outil tel que l'utilitaire dig:

   # dig @ipa-server zone_name AXFR

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnszone:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnszone

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier dnszone-present.yml Ansible playbook. Par exemple :

   $ cp dnszone-present.yml dnszone-present-copy.yml

4. Ouvrez le fichier dnszone-present-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnszone task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.

   • Fixer la variable zone_name à zone.idm.example.com.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Ensure dnszone present
     hosts: ipaserver
     become: true
   
     tasks:
     - name: Ensure zone is present.
       ipadnszone:
         ipaadmin_password: "{{ ipaadmin_password }}"
         zone_name: zone.idm.example.com
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file dnszone-present-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnszone:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnszone

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier dnszone-all-params.yml Ansible playbook. Par exemple :

   $ cp dnszone-all-params.yml dnszone-all-params-copy.yml

4. Ouvrez le fichier dnszone-all-params-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnszone task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Fixer la variable zone_name à zone.idm.example.com.
   • Attribuez la valeur true à la variable allow_sync_ptr si vous souhaitez autoriser la synchronisation des enregistrements en aval et en amont, c'est-à-dire la synchronisation des enregistrements A et AAAA avec les enregistrements PTR.
   • Définissez la variable dynamic_update sur true pour permettre aux machines clientes IdM d'ajouter ou de mettre à jour leurs adresses IP.
   • Attribuez la valeur true à la variable dnssec pour permettre la signature DNSSEC en ligne des enregistrements dans la zone.
   • Définissez la variable allow_transfer avec les adresses IP des serveurs de noms secondaires de la zone.
   • Définissez la variable allow_query en fonction des adresses IP ou des réseaux autorisés à émettre des requêtes.
   • Définissez la variable forwarders avec les adresses IP des transitaires globaux.
   • Attribuer à la variable serial le numéro de série de l'enregistrement SOA.
   • Définissez les valeurs refresh, retry, expire, minimum, ttl, et default_ttl pour les enregistrements DNS de la zone.
   • Définir l'enregistrement NSEC3PARAM pour la zone en utilisant la variable nsec3param_rec.
   • Définissez la variable skip_overlap_check sur true pour forcer la création d'un DNS même s'il chevauche une zone existante.

   • Attribuez la valeur true à skip_nameserver_check pour forcer la création d'une zone DNS même si le serveur de noms n'est pas résolvable.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Ensure dnszone present
     hosts: ipaserver
     become: true
   
     tasks:
     - name: Ensure zone is present.
       ipadnszone:
         ipaadmin_password: "{{ ipaadmin_password }}"
         zone_name: zone.idm.example.com
         allow_sync_ptr: true
         dynamic_update: true
         dnssec: true
         allow_transfer:
           - 1.1.1.1
           - 2.2.2.2
         allow_query:
           - 1.1.1.1
           - 2.2.2.2
         forwarders:
           - ip_address: 8.8.8.8
           - ip_address: 8.8.4.4
             port: 52
         serial: 1234
         refresh: 3600
         retry: 900
         expire: 1209600
         minimum: 3600
         ttl: 60
         default_ttl: 90
         name_server: server.idm.example.com.
         admin_email: admin.admin@idm.example.com
         nsec3param_rec: "1 7 100 0123456789abcdef"
         skip_overlap_check: true
         skip_nameserver_check: true
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file dnszone-all-params-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnszone:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnszone

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier dnszone-reverse-from-ip.yml Ansible playbook. Par exemple :

   $ cp dnszone-reverse-from-ip.yml dnszone-reverse-from-ip-copy.yml

4. Ouvrez le fichier dnszone-reverse-from-ip-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnszone task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.

   • Définissez la variable name_from_ip avec l'IP de votre serveur de noms IdM et indiquez la longueur de son préfixe.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

     ---
     - name: Ensure dnszone present
       hosts: ipaserver
       become: true
     
       tasks:
       - name: Ensure zone for reverse DNS lookup is present.
         ipadnszone:
           ipaadmin_password: "{{ ipaadmin_password }}"
           name_from_ip: 192.168.1.2/24
           state: present
         register: result
       - name: Display inferred zone name.
         debug:
           msg: "Zone name: {{ result.dnszone.name }}"

   Le playbook crée une zone pour la recherche DNS inversée à partir de l'adresse IP 192.168.1.2 et de sa longueur de préfixe de 24. Ensuite, le playbook affiche le nom de la zone résultante.

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file dnszone-reverse-from-ip-copy.yml

Procédure

1. Ouvrez l'onglet IPA Server.
2. Sélectionnez le sous-onglet Topology.
3. Cliquez sur IPA Locations dans la barre de navigation.
4. Cliquez sur Ajouter en haut de la liste des lieux.
5. Complétez le nom de l'emplacement.
6. Cliquez sur le bouton Ajouter pour enregistrer l'emplacement.
7. Facultatif : Répétez les étapes pour ajouter d'autres lieux.

Procédure

1. Par exemple, pour créer un nouvel emplacement germany, entrez :

   $ ipa location-add germany
   ----------------------------
   Added IPA location "germany"
   ----------------------------
     Location name: germany

2. Facultatif : Répétez l'étape pour ajouter d'autres lieux.

Procédure

1. Ouvrez l'onglet IPA Server.
2. Sélectionnez le sous-onglet Topology.
3. Cliquez sur IPA Servers dans la navigation.
4. Cliquez sur le nom du serveur IdM.

5. Sélectionnez un emplacement DNS et définissez éventuellement un poids de service :

   Figure 4.1. Attribution d'un serveur à un emplacement DNS

   
6. Cliquez sur Enregistrer.

7. Dans l'interface de ligne de commande (CLI) de l'hôte auquel vous avez attribué l'emplacement DNS dans les étapes précédentes, redémarrez le service named-pkcs11:

   [root@idmserver-01 ~]# systemctl restart named-pkcs11

8. Facultatif : Répétez les étapes pour attribuer des emplacements DNS à d'autres serveurs IdM.

Procédure

1. Optionnel : Liste de tous les emplacements DNS configurés :

   [root@server ~]# ipa location-find
   -----------------------
   2 IPA locations matched
   -----------------------
   Location name: australia
   Location name: germany
   -----------------------------
   Number of entries returned: 2
   -----------------------------

2. Attribuez le serveur à l'emplacement DNS. Par exemple, pour attribuer l'emplacement germany au serveur idmserver-01.idm.example.com, exécutez :

   # ipa server-mod idmserver-01.idm.example.com --location=germany
   ipa: WARNING: Service named-pkcs11.service requires restart on IPA server
   idmserver-01.idm.example.com to apply configuration changes.
   --------------------------------------------------
   Modified IPA server "idmserver-01.idm.example.com"
   --------------------------------------------------
   Servername: idmserver-01.idm.example.com
   Min domain level: 0
   Max domain level: 1
   Location: germany
   Enabled server roles: DNS server, NTP server

3. Redémarrez le service named-pkcs11 sur l'hôte auquel vous avez attribué l'emplacement DNS dans les étapes précédentes :

   # systemctl restart named-pkcs11

4. Facultatif : Répétez les étapes pour attribuer des emplacements DNS à d'autres serveurs IdM.

Procédure

1. Naviguez jusqu'au répertoire ~/MyPlaybooks/ répertoire :

   $ cd ~/MyPlaybooks/

2. Faites une copie du fichier location-present.yml situé dans le répertoire /usr/share/doc/ansible-freeipa/playbooks/location/:

   $ cp /usr/share/doc/ansible-freeipa/playbooks/location/location-present.yml location-present-copy.yml

3. Ouvrez le fichier location-present-copy.yml Ansible playbook pour l'éditer.

4. Adaptez le fichier en définissant les variables suivantes dans la section ipalocation task :

   • Adaptez le site name de la tâche pour qu'il corresponde à votre cas d'utilisation.
   • Définissez la variable ipaadmin_password avec le mot de passe de l'administrateur IdM.
   • Définissez la variable name avec le nom de l'emplacement.

   Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: location present example
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure that the "germany" location is present
       ipalocation:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: germany

5. Enregistrer le fichier.

6. Exécutez le playbook Ansible. Spécifiez le fichier du livre de jeu, le fichier contenant le mot de passe protégeant le fichier secret.yml et le fichier d'inventaire :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory location-present-copy.yml

Procédure

1. Naviguez jusqu'au répertoire ~/MyPlaybooks/ répertoire :

   $ cd ~/MyPlaybooks/

2. Faites une copie du fichier location-absent.yml situé dans le répertoire /usr/share/doc/ansible-freeipa/playbooks/location/:

   $ cp /usr/share/doc/ansible-freeipa/playbooks/location/location-absent.yml location-absent-copy.yml

3. Ouvrez le fichier location-absent-copy.yml Ansible playbook pour l'éditer.

4. Adaptez le fichier en définissant les variables suivantes dans la section ipalocation task :

   • Adaptez le site name de la tâche pour qu'il corresponde à votre cas d'utilisation.
   • Définissez la variable ipaadmin_password avec le mot de passe de l'administrateur IdM.
   • Définissez la variable name avec le nom de l'emplacement DNS.
   • Assurez-vous que la variable state est fixée à absent.

   Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: location absent example
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure that the "germany" location is absent
       ipalocation:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: germany
         state: absent

5. Enregistrer le fichier.

6. Exécutez le playbook Ansible. Spécifiez le fichier du livre de jeu, le fichier contenant le mot de passe protégeant le fichier secret.yml et le fichier d'inventaire :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory location-absent-copy.yml

Procédure

1. Dans l'interface Web IdM, sélectionnez Network Services → DNS Global Configuration → DNS.

   

2. Dans la section DNS Global Configuration, cliquez sur Add.

   

3. Spécifiez l'adresse IP du serveur DNS qui recevra les requêtes DNS transférées.

   

4. Sélectionnez le site Forward policy.

   
5. Cliquez sur Save en haut de la fenêtre.

Verification steps

1. Sélectionnez Network Services → DNS Global Configuration → DNS.

   

2. Vérifiez que le transitaire global, avec la politique de transfert que vous avez spécifiée, est présent et activé dans l'interface utilisateur Web IdM.

   

Procédure

1. Dans l'interface Web IdM, sélectionnez Network Services → DNS Forward Zones → DNS.

   

2. Dans la section DNS Forward Zones, cliquez sur Add.

   

3. Dans la fenêtre Add DNS forward zone, indiquez le nom de la zone de transfert.

   

4. Cliquez sur le bouton Add et indiquez l'adresse IP d'un serveur DNS qui recevra la demande de transfert. Vous pouvez spécifier plusieurs serveurs de transfert par zone de transfert.

   

5. Sélectionnez le site Forward policy.

   
6. Cliquez sur Add en bas de la fenêtre pour ajouter la nouvelle zone de transmission.

Verification steps

1. Dans l'interface Web IdM, sélectionnez Network Services → DNS Forward Zones → DNS.

   

2. Vérifiez que la zone de transfert que vous avez créée, avec les transitaires et la politique de transfert que vous avez spécifiés, est présente et activée dans l'interface utilisateur Web d'IdM.

   

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier set-configuration.yml Ansible playbook. Par exemple :

   cp set-configuration.yml establish-global-forwarder.yml

4. Ouvrez le fichier establish-global-forwarder.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to establish a global forwarder in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Create a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800.

   3. Dans la section forwarders de la partie ipadnsconfig:

      1. Remplacez la première valeur de ip_address par l'adresse IPv4 du transitaire global : 8.8.6.6.
      2. Remplacer la deuxième valeur ip_address par l'adresse IPv6 du transitaire global : 2001:4860:4860::8800.
      3. Vérifiez que la valeur port est définie sur 53.

   4. Modifier le forward_policy en first.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to establish a global forwarder in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Create a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800
       ipadnsconfig:
         forwarders:
           - ip_address: 8.8.6.6
           - ip_address: 2001:4860:4860::8800
             port: 53
         forward_policy: first
         allow_sync_ptr: yes

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file establish-global-forwarder.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-presence-of-a-global-forwarder.yml

4. Ouvrez le fichier ensure-presence-of-a-global-forwarder.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the presence of a global forwarder in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure the presence of a DNS global forwarder to 7.7.9.9 and 2001:db8::1:0 on port 53.

   3. Dans la section forwarders de la partie ipadnsconfig:

      1. Remplacez la première valeur de ip_address par l'adresse IPv4 du transitaire global : 7.7.9.9.
      2. Remplacer la deuxième valeur ip_address par l'adresse IPv6 du transitaire global : 2001:db8::1:0.
      3. Vérifiez que la valeur port est définie sur 53.

   4. Modifier le state en present.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the presence of a global forwarder in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the presence of a DNS global forwarder to 7.7.9.9 and 2001:db8::1:0 on port 53
       ipadnsconfig:
         forwarders:
           - ip_address: 7.7.9.9
           - ip_address: 2001:db8::1:0
             port: 53
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-presence-of-a-global-forwarder.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-absence-of-a-global-forwarder.yml

4. Ouvrez le fichier ensure-absence-of-a-global-forwarder.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the absence of a global forwarder in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure the absence of a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800 on port 53.

   3. Dans la section forwarders de la partie ipadnsconfig:

      1. Remplacez la première valeur de ip_address par l'adresse IPv4 du transitaire global : 8.8.6.6.
      2. Remplacer la deuxième valeur ip_address par l'adresse IPv6 du transitaire global : 2001:4860:4860::8800.
      3. Vérifiez que la valeur port est définie sur 53.
   4. Fixer la variable action à member.
   5. Vérifiez que state est défini sur absent.

   Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the absence of a global forwarder in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the absence of a DNS global forwarder to 8.8.6.6 and 2001:4860:4860::8800 on port 53
       ipadnsconfig:
         forwarders:
           - ip_address: 8.8.6.6
           - ip_address: 2001:4860:4860::8800
             port: 53
         action: member
         state: absent

   Important

   Si vous n'utilisez que l'option state: absent dans votre séquence sans utiliser également action: member, la séquence échoue.

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-absence-of-a-global-forwarder.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Vérifiez le contenu du fichier disable-global-forwarders.yml Ansible playbook qui est déjà configuré pour désactiver toutes les redirections globales DNS. Par exemple :

   $ cat disable-global-forwarders.yml
   ---
   - name: Playbook to disable global DNS forwarders
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Disable global forwarders.
       ipadnsconfig:
         forward_policy: none

4. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file disable-global-forwarders.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   cp forwarders-absent.yml ensure-presence-forwardzone.yml

4. Ouvrez le fichier ensure-presence-forwardzone.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the presence of a dnsforwardzone in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure presence of a dnsforwardzone for example.com to 8.8.8.8.
   3. Dans la section tasks, remplacez le titre ipadnsconfig par ipadnsforwardzone.

   4. Dans la section ipadnsforwardzone:

      1. Ajoutez la variable ipaadmin_password et définissez-la comme votre mot de passe d'administrateur IdM.
      2. Ajoutez la variable name et fixez-la à example.com.

      3. Dans la section forwarders:

         1. Supprimer les lignes ip_address et port.

         2. Ajoutez l'adresse IP du serveur DNS qui doit recevoir les requêtes transférées en la spécifiant après un tiret :

            - 8.8.8.8

      4. Ajoutez la variable forwardpolicy et fixez-la à first.
      5. Ajoutez la variable skip_overlap_check et fixez-la à true.
      6. Remplacez la variable state par present.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the presence of a dnsforwardzone in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the presence of a dnsforwardzone for example.com to 8.8.8.8
     ipadnsforwardzone:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: example.com
         forwarders:
             - 8.8.8.8
         forwardpolicy: first
         skip_overlap_check: true
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-presence-forwardzone.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   cp forwarders-absent.yml ensure-presence-multiple-forwarders.yml

4. Ouvrez le fichier ensure-presence-multiple-forwarders.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the presence of multiple forwarders in a dnsforwardzone in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure presence of 8.8.8.8 and 4.4.4.4 forwarders in dnsforwardzone for example.com.
   3. Dans la section tasks, remplacez le titre ipadnsconfig par ipadnsforwardzone.

   4. Dans la section ipadnsforwardzone:

      1. Ajoutez la variable ipaadmin_password et définissez-la comme votre mot de passe d'administrateur IdM.
      2. Ajoutez la variable name et fixez-la à example.com.

      3. Dans la section forwarders:

         1. Supprimer les lignes ip_address et port.

         2. Ajoutez l'adresse IP des serveurs DNS dont vous voulez vous assurer de la présence, précédée d'un tiret :

            - 8.8.8.8
            - 4.4.4.4

      4. Modifier la variable d'état pour qu'elle devienne présente.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: name: Playbook to ensure the presence of multiple forwarders in a dnsforwardzone in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure presence of 8.8.8.8 and 4.4.4.4 forwarders in dnsforwardzone for example.com
     ipadnsforwardzone:
         ipaadmin_password: "{{ ipaadmin_password }}"
        name: example.com
         forwarders:
             - 8.8.8.8
             - 4.4.4.4
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-presence-multiple-forwarders.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-disabled-forwardzone.yml

4. Ouvrez le fichier ensure-disabled-forwardzone.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure a dnsforwardzone is disabled in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure a dnsforwardzone for example.com is disabled.
   3. Dans la section tasks, remplacez le titre ipadnsconfig par ipadnsforwardzone.

   4. Dans la section ipadnsforwardzone:

      1. Ajoutez la variable ipaadmin_password et définissez-la comme votre mot de passe d'administrateur IdM.
      2. Ajoutez la variable name et fixez-la à example.com.
      3. Retirer toute la section forwarders.
      4. Remplacez la variable state par disabled.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure a dnsforwardzone is disabled in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure a dnsforwardzone for example.com is disabled
     ipadnsforwardzone:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: example.com
         state: disabled

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-disabled-forwardzone.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsconfig:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsconfig

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier forwarders-absent.yml Ansible playbook. Par exemple :

   $ cp forwarders-absent.yml ensure-absence-forwardzone.yml

4. Ouvrez le fichier ensure-absence-forwardzone.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes :

   1. Modifiez la variable name du playbook en Playbook to ensure the absence of a dnsforwardzone in IdM DNS.
   2. Dans la section tasks, changez le name de la tâche en Ensure the absence of a dnsforwardzone for example.com.
   3. Dans la section tasks, remplacez le titre ipadnsconfig par ipadnsforwardzone.

   4. Dans la section ipadnsforwardzone:

      1. Ajoutez la variable ipaadmin_password et définissez-la comme votre mot de passe d'administrateur IdM.
      2. Ajoutez la variable name et fixez-la à example.com.
      3. Retirer toute la section forwarders.
      4. Laissez la variable state comme absent.

      Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Playbook to ensure the absence of a dnsforwardzone in IdM DNS
     hosts: ipaserver
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Ensure the absence of a dnsforwardzone for example.com
       ipadnsforwardzone:
          ipaadmin_password: "{{ ipaadmin_password }}"
          name: example.com
          state: absent

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-absence-forwardzone.yml

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.
2. Cliquez sur la zone DNS à laquelle vous souhaitez ajouter un enregistrement DNS.

3. Dans la section DNS Resource Records, cliquez sur Ajouter pour ajouter un nouvel enregistrement.

   Figure 7.1. Ajout d'un nouvel enregistrement de ressources DNS

   

4. Sélectionnez le type d'enregistrement à créer et remplissez les autres champs si nécessaire.

   Figure 7.2. Définition d'un nouvel enregistrement de ressource DNS

   
5. Cliquez sur Ajouter pour confirmer le nouvel enregistrement.

Procédure

1. Pour ajouter un enregistrement de ressource DNS, utilisez la commande ipa dnsrecord-add. La commande suit la syntaxe suivante :

   $ ipa dnsrecord-add zone_name record_name --record_type_option=data

   Dans la commande ci-dessus :

   • Le zone_name est le nom de la zone DNS à laquelle l'enregistrement est ajouté.
   • Le record_name est un identifiant pour le nouvel enregistrement de ressource DNS.

   Par exemple, pour ajouter un enregistrement DNS de type A de host1 à la zone idm.example.com, entrez :

   $ ipa dnsrecord-add idm.example.com host1 --a-rec=192.168.122.123

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.
2. Cliquez sur la zone dont vous souhaitez supprimer un enregistrement DNS, par exemple example.com..

3. Dans la section DNS Resource Records, cliquez sur le nom de l'enregistrement de ressource.

   Figure 7.3. Sélection d'un enregistrement de ressource DNS

   
4. Cochez la case correspondant au nom du type d'enregistrement à supprimer.

5. Cliquez sur Delete.

   Figure 7.4. Suppression d'un enregistrement de ressource DNS

   

Procédure

1. Dans l'interface Web IdM, cliquez sur Network Services → DNS → DNS Zones.
2. Cliquez sur la zone dont vous souhaitez supprimer un enregistrement DNS, par exemple zone.example.com..
3. Dans la section DNS Resource Records, cochez la case de l'enregistrement de ressource à supprimer.

4. Click Delete.

   Figure 7.5. Suppression d'un enregistrement de ressource entier

   

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsrecord:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier ensure-A-and-AAAA-records-are-present.yml Ansible playbook. Par exemple :

   $ cp ensure-A-and-AAAA-records-are-present.yml ensure-A-and-AAAA-records-are-present-copy.yml

4. Ouvrez le fichier ensure-A-and-AAAA-records-are-present-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsrecord task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Fixer la variable zone_name à idm.example.com.
   • Dans la variable records, fixez la variable name à host1, et la variable a_ip_address à 192.168.122.123.

   • Dans la variable records, fixez la variable name à host1, et la variable aaaa_ip_address à ::1.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Ensure A and AAAA records are present
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     # Ensure A and AAAA records are present
     - name: Ensure that 'host1' has A and AAAA records.
       ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         zone_name: idm.example.com
         records:
         - name: host1
           a_ip_address: 192.168.122.123
         - name: host1
           aaaa_ip_address: ::1

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-A-and-AAAA-records-are-present-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsrecord:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier ensure-dnsrecord-with-reverse-is-present.yml Ansible playbook. Par exemple :

   $ cp ensure-dnsrecord-with-reverse-is-present.yml ensure-dnsrecord-with-reverse-is-present-copy.yml

4. Ouvrez le fichier ensure-dnsrecord-with-reverse-is-present-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsrecord task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Fixer la variable name à host1.
   • Fixer la variable zone_name à idm.example.com.
   • Fixer la variable ip_address à 192.168.122.45.

   • Fixer la variable create_reverse à yes.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Ensure DNS Record is present.
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     # Ensure that dns record is present
     - ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: host1
         zone_name: idm.example.com
         ip_address: 192.168.122.45
         create_reverse: yes
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-dnsrecord-with-reverse-is-present-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsrecord:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier ensure-presence-multiple-records.yml Ansible playbook. Par exemple :

   $ cp ensure-presence-multiple-records.yml ensure-presence-multiple-records-copy.yml

4. Ouvrez le fichier ensure-presence-multiple-records-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsrecord task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Dans la section records, fixez la variable name à host1.
   • Dans la section records, la variable zone_name est remplacée par idm.example.com.
   • Dans la section records, la variable a_rec doit être remplacée par 192.168.122.112 et 192.168.122.122.

   • Définir un deuxième enregistrement dans la section records:

     • Fixer la variable name à host1.
     • Fixer la variable zone_name à idm.example.com.
     • Fixer la variable aaaa_rec à ::1.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Test multiple DNS Records are present.
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     # Ensure that multiple dns records are present
     - ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         records:
           - name: host1
             zone_name: idm.example.com
             a_rec: 192.168.122.112
             a_rec: 192.168.122.122
           - name: host1
             zone_name: idm.example.com
             aaaa_rec: ::1

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-presence-multiple-records-copy.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsrecord:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier ensure-CNAME-record-is-present.yml Ansible playbook. Par exemple :

   $ cp ensure-CNAME-record-is-present.yml ensure-CNAME-record-is-present-copy.yml

4. Ouvrez le fichier ensure-CNAME-record-is-present-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsrecord task :

   • (Facultatif) Adaptez la description de la pièce fournie par le site name.
   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Fixer la variable zone_name à idm.example.com.

   • Dans la section des variables de records, définissez les variables et valeurs suivantes :

     • Fixer la variable name à www.
     • Fixer la variable cname_hostname à host03.
     • Fixer la variable name à ftp.
     • Fixer la variable cname_hostname à host03.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Ensure that 'www.idm.example.com' and 'ftp.idm.example.com' CNAME records point to 'host03.idm.example.com'.
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     - ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         zone_name: idm.example.com
         records:
         - name: www
           cname_hostname: host03
         - name: ftp
           cname_hostname: host03

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-CNAME-record-is-present.yml

Procédure

1. Naviguez jusqu'au répertoire /usr/share/doc/ansible-freeipa/playbooks/dnsrecord:

   $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

2. Ouvrez votre fichier d'inventaire et assurez-vous que le serveur IdM que vous souhaitez configurer est répertorié dans la section [ipaserver]. Par exemple, pour demander à Ansible de configurer server.idm.example.com, entrez :

   [ipaserver]
   server.idm.example.com

3. Faites une copie du fichier ensure-SRV-record-is-present.yml Ansible playbook. Par exemple :

   $ cp ensure-SRV-record-is-present.yml ensure-SRV-record-is-present-copy.yml

4. Ouvrez le fichier ensure-SRV-record-is-present-copy.yml pour le modifier.

5. Adaptez le fichier en définissant les variables suivantes dans la section ipadnsrecord task :

   • Définissez la variable ipaadmin_password avec votre mot de passe d'administrateur IdM.
   • Fixer la variable name à _kerberos._udp.idm.example.com.
   • Fixer la variable srv_rec à '10 50 88 idm.example.com'.

   • Fixer la variable zone_name à idm.example.com.

     Il s'agit du fichier playbook Ansible modifié pour l'exemple actuel :

   ---
   - name: Test multiple DNS Records are present.
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     # Ensure a SRV record is present
     - ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: _kerberos._udp.idm.example.com
         srv_rec: ’10 50 88 idm.example.com’
         zone_name: idm.example.com
         state: present

6. Enregistrer le fichier.

7. Exécutez le manuel de jeu :

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-SRV-record-is-present.yml

Procédure

1. S'authentifier auprès de l'IdM en tant qu'utilisateur de admin:

   kinit admin

2. Ajoutez l'alias au principal de l'hôte. Par exemple, pour ajouter l'alias demo au principal de l'hôte demo.examle.com:

   $ ipa host-add-principal demo.example.com --principal=demo

Procédure

1. Dans la section [libdefaults] du fichier /etc/krb5.conf, le paramètre dns_canonicalize_hostname doit être réglé sur false:

   [libdefaults]
   ...
   dns_canonicalize_hostname = true