SSHFP record

A Secure Shell fingerprint record (abbreviated as SSHFP record) is a type of resource record in the Domain Name System (DNS) which identifies SSH keys that are associated with a host name. The acquisition of an SSHFP record needs to be secured with a mechanism such as DNSSEC for a chain of trust to be established.

Structure

{{pre|{{angbr|Name}} [{{angbr|TTL}}] [{{angbr|Class}}] SSHFP {{angbr|Algorithm}} {{angbr|Type}} {{angbr|Fingerprint}}}}

; {{angbr|Name}}: The name of the object to which the resource record belongs (optional)

; {{angbr|TTL}}: Time to live (in seconds). Validity of Resource Records (optional)

; {{angbr|Class}}: Protocol group to which the resource record belongs (optional)

; {{angbr|Algorithm}}: Algorithm (0: reserved, 1: RSA, 2: DSA, 3: ECDSA, 4: Ed25519, 6: Ed448)

; {{angbr|Type}}: Algorithm used to hash the public key (0: reserved, 1: SHA-1, 2: SHA-256)

; {{angbr|Fingerprint}}: Hexadecimal representation of the hash result, as text

Example

{{sxhl|host.example.com. SSHFP 4 2 123456789abcdef67890123456789abcdef67890123456789abcdef123456789|zone}}

In this example, the host with the domain name host.example.com uses a Ed25519 key with the SHA-256 fingerprint 123456789abcdef67890123456789abcdef67890.

This output would be produced by a ssh-keygen -r host.example.com. command on the target server by reading the existing default SSH host key (Ed25519).{{Cite web |title=ssh-keygen(1) - OpenBSD manual pages |url=https://man.openbsd.org/ssh-keygen#r |access-date=2025-05-30 |website=man.openbsd.org}} In newer releases of the OpenSSH suite, ssh-keyscan -D $HOSTNAME{{Cite web |title=ssh-keyscan(1) - OpenBSD manual pages |url=https://man.openbsd.org/ssh-keyscan.1#D |access-date=2025-05-30 |website=man.openbsd.org}} can be used to produce a similar result, by connecting to the host over the network.

See also

References

{{cite web |url=https://tools.ietf.org/html/rfc4255 |title=RFC 4255 — Using DNS to Securely Publish Secure Shell (SSH) Key Fingerprints |date=January 2006 |access-date=2017-12-28 |last1=Griffin |first1=Wesley |last2=Schlyter |first2=Jakob }}

{{cite web |url=https://tools.ietf.org/html/rfc6594 |title=RFC 6594 — Use of the SHA-256 Algorithm with RSA, Digital Signature Algorithm (DSA), and Elliptic Curve DSA (ECDSA) in SSHFP Resource Records |date=April 2012 |access-date=2017-12-28 |last1=Surý |first1=Ondřej }}

{{cite web |url=https://tools.ietf.org/html/rfc7479 |title=RFC 7479 — Using Ed25519 in SSHFP Resource Records |date=March 2015 |access-date=2017-12-28 |last1=Moonesamy |first1=S. }}

{{cite web |url=https://tools.ietf.org/html/rfc8709 |title=RFC 8709 — Ed25519 and Ed448 Public Key Algorithms for the Secure Shell (SSH) Protocol |date=February 2020 |access-date=2021-10-16 |last1=Harris |first1=Ben |last2=Velvindron |first2=Loganaden }}

Category:Internet Standards

Category:Internet protocols

Category:DNS record types

Category:Key management

Category:Secure Shell