This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
extensions:teemip-zone-mgmt [2023/07/25 16:39] – [TLSA Records] cnaud | extensions:teemip-zone-mgmt [2024/04/04 14:59] – [Revision History] cnaud | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{ icons8-zone-48.png}} | + | {{ picto_dnszonemanagement.png}} |
====== DNS Zone Management ====== | ====== DNS Zone Management ====== | ||
---- dataentry summary ---- | ---- dataentry summary ---- | ||
Line 6: | Line 6: | ||
index_hidden | index_hidden | ||
level_hidden | level_hidden | ||
- | version | + | collector_hidden |
- | release_dt | + | version |
- | TeemIp | + | release_dt |
- | iTop : 3.x | + | TeemIp |
+ | iTop : 3.1+ | ||
code : teemip-zone-mgmt | code : teemip-zone-mgmt | ||
localization | localization | ||
Line 18: | Line 19: | ||
keyword_tags | keyword_tags | ||
dependencies_s | dependencies_s | ||
- | download_wiki | + | download_wiki |
github_wiki | github_wiki | ||
php-max | php-max | ||
---- | ---- | ||
+ | |||
Line 30: | Line 32: | ||
</ | </ | ||
===== Revision History ===== | ===== Revision History ===== | ||
- | ^ Version | + | ^ Version |
- | | 3.1.0 | 2023-06-21 | + | | 3.1.2 | 2024-xx-yy |
- | | 3.0.1 | 2022-09-09 | + | | **3.1.1** |
- | | 3.0.0 | 2022-01-05 | + | | 3.1.0 | 2023-06-21 |
- | | 2.7.1 | 2021-04-01 | + | | 3.0.1 | 2022-09-09 |
- | | 2.7.0 | 2020-12-11 | + | | 3.0.0 | 2022-01-05 |
- | | 2.6.2 | 2020-06-22 | + | | 2.7.1 | 2021-04-01 |
- | | 2.6.1 | 2020-05-08 | + | | 2.7.0 | 2020-12-11 |
- | | 2.6.0 | 2020-04-14 | + | | 2.6.2 | 2020-06-22 |
- | | 1.2.0 | 2019-12-10 | + | | 2.6.1 | 2020-05-08 |
- | | 1.1.0 | 2019-09-24 | + | | 2.6.0 | 2020-04-14 |
- | | 1.0.0 | 2019-02-09 | + | | 1.2.0 | 2019-12-10 |
+ | | 1.1.0 | 2019-09-24 | ||
+ | | 1.0.0 | 2019-02-09 | ||
===== Features ===== | ===== Features ===== | ||
Line 240: | Line 244: | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| IPv4 Address | Foreign key to a(n) IPv4 Address | Yes | | | IPv4 Address | Foreign key to a(n) IPv4 Address | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 259: | Line 263: | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| IPv6 Address | Foreign key to a(n) IPv6 Address | Yes | | | IPv6 Address | Foreign key to a(n) IPv6 Address | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Update === | === Update === | ||
Line 278: | Line 282: | ||
| Tag | Possible values: Iodef, Issue, Issue Wild | | | Tag | Possible values: Iodef, Issue, Issue Wild | | ||
| Value | Strings associated with tags | | | Value | Strings associated with tags | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Creation === | === Creation === | ||
Line 297: | Line 301: | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| CNAME | Alphanumeric string | Yes | | | CNAME | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Creation === | === Creation === | ||
Line 318: | Line 322: | ||
| Digest Type | Cryptographic hash algorithm used to create the Digest value | No | | | Digest Type | Cryptographic hash algorithm used to create the Digest value | No | | ||
| Digest | A cryptographic hash value of the referenced DNSKEY-record |Yes | | | Digest | A cryptographic hash value of the referenced DNSKEY-record |Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 337: | Line 341: | ||
| Preference | Integer | No | | | Preference | Integer | No | | ||
| Exchange Server | Alphanumeric string | Yes | | | Exchange Server | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 355: | Line 359: | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| Name Server | Alphanumeric string | Yes | | | Name Server | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 362: | Line 366: | ||
==== OPENPGPKEY records ==== | ==== OPENPGPKEY records ==== | ||
- | FIXME | + | {{icons8-secured-mail.svg |
+ | This object is used to document the OPENPGPKEY record. Such record stores the OpenPGP public keys used to encrypt or sign email messages and files. | ||
+ | === Properties === | ||
+ | ^ Name ^ Type ^ Mandatory? | ||
+ | | Organization | Foreign key to a(n) Organization | Yes | | ||
+ | | Zone | Foreign key to a(n) Zone | Yes | | ||
+ | | RR Name | Alphanumeric string | Yes | | ||
+ | | Overwrite zone TTL | Yes or No | No | | ||
+ | | TTL | d/h/m/s | N/A | | ||
+ | | OpenPGP Public Key | Multiline character string | Yes | | ||
+ | | Comment | Alphanumeric string | No | | ||
+ | |||
+ | === Creation === | ||
+ | A new OPENPGPKEY record may be created from the specific " | ||
+ | {{ classcreate_openpgpkeyrecord3x.png }} | ||
==== PTR Records ==== | ==== PTR Records ==== | ||
Line 377: | Line 395: | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| Hostname | Alphanumeric string | Yes | | | Hostname | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 398: | Line 416: | ||
| Digest Type| Integer | No | | | Digest Type| Integer | No | | ||
| Fingerprint | Alphanumeric string | Yes | | | Fingerprint | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 419: | Line 437: | ||
| Port | Integer | No | | | Port | Integer | No | | ||
| Target| Alphanumeric string | Yes | | | Target| Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Creation === | === Creation === | ||
Line 440: | Line 458: | ||
| Matching Type | Integer | No | | | Matching Type | Integer | No | | ||
| Certificate Association Data | Alphanumeric string | Yes | | | Certificate Association Data | Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
=== Details === | === Details === | ||
Line 453: | Line 471: | ||
=== Properties === | === Properties === | ||
^ Name ^ Type ^ Mandatory? | ^ Name ^ Type ^ Mandatory? | ||
+ | | **Zone** ||| | ||
| Organization | Foreign key to a(n) Organization | Yes | | | Organization | Foreign key to a(n) Organization | Yes | | ||
| Zone | Foreign key to a(n) Zone | Yes | | | Zone | Foreign key to a(n) Zone | Yes | | ||
+ | | **RRs attributes** ||| | ||
| RR Name | Alphanumeric string | | RR Name | Alphanumeric string | ||
| Overwrite zone TTL | Yes or No | No | | | Overwrite zone TTL | Yes or No | No | | ||
| TTL | d/h/m/s | N/A | | | TTL | d/h/m/s | N/A | | ||
| Text| Alphanumeric string | Yes | | | Text| Alphanumeric string | Yes | | ||
- | | Comment | Multiline character | + | | Comment | Alphanumeric |
+ | | **Chaining** ||| | ||
+ | | Previous segment | Foreign key to a(n) TXT Record | No | | ||
+ | | Next segment | Foreign key to a(n) TXT Record | ||
=== Update === | === Update === | ||
- | A TXT record may be updated from the detailed view of the object. | + | A TXT record may be updated from the detailed view of the object. |
{{ classupdate_txtrecord3x.png }} | {{ classupdate_txtrecord3x.png }} | ||
+ | |||
+ | === TXT Records with a payload over 255 chars == | ||
+ | A TXT record may have more than 255 characters of data, but **not** more than 255 characters in a single string, which is problematic for long chains like DKIM keys. RFC 4408 defines how to get around this limitation : a TXT record is allowed to contain multiple strings which should then be concatenated together by the reading application. TeemIP implements this concept through a chaining mechanism. | ||
+ | |||
+ | <note tip> | ||
+ | When a segment is set in a given TXT record, its counter part is automatically updated. | ||
+ | * If **Previous segment** of record R1 is set to R0, then TeemIP will set **Next segment** of record R0 to R1 | ||
+ | * If **Next segment** of record R1 is set to R2, then TeemIp will set **Previous segment** of record R2 to R1 | ||
+ | </ | ||
+ | <note warning> | ||
+ | In a chain, only the RR Name of the **first segment** is relevant. It is considered as the reference for the TXT Record when the db file is built. The name of the following records of the chain are just used to name the objects. | ||
+ | </ | ||
+ | {{ classupdate_txtrecord3x-2.png }} | ||
+ | |||
+ | The tool that generates Zone data files will take the chain into consideration and will create the proper entry in the db file as shown in the exemple below: | ||
+ | |||
+ | {{ dbfile_long_txtrecord.png }} | ||
==== Generic Records ==== | ==== Generic Records ==== | ||
- | FIXME | + | {{icons8-music-record.svg |
+ | Most popular or usefull DNS resource records have been documented in TeemIp. However, in the case where Hostmasters need to do document other types of records, a generic class has been created. It enables the raw edition of any type of records by opening to edition the whole payload of a DNS resource record. | ||
+ | |||
+ | === Properties === | ||
+ | ^ Name ^ Type ^ Mandatory? | ||
+ | | Organization | Foreign key to a(n) Organization | Yes | | ||
+ | | Zone | Foreign key to a(n) Zone | Yes | | ||
+ | | RR Name | Alphanumeric string | ||
+ | | Overwrite zone TTL | Yes or No | No | | ||
+ | | TTL | d/h/m/s | N/A | | ||
+ | | Type | Foreign key to a(n) Resource Record Type | Yes | | ||
+ | | Payload | Alphanumeric string | No | | ||
+ | | Comment | Alphanumeric string | No | | ||
+ | |||
+ | === Details === | ||
+ | A Generic record may be displayed from the specific “GENERIC” shortcut menu of the DNS Management module. | ||
+ | {{ classdetails_genericrecord3x.png }} | ||
+ | |||
+ | Resource Record types are typological elements. They are managed from the "IP space typology configuration" | ||
+ | {{ classlist_resourcerecordtype.png }} | ||
==== Link with IP Addresses ==== | ==== Link with IP Addresses ==== |