Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SSH audit events and contexts #28

Merged
merged 8 commits into from
Jun 29, 2023
29 changes: 29 additions & 0 deletions docs/logging-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -228,6 +228,35 @@ and TLS probe points.
| `tls::key_exchange_algorithm` | uint16 | Key exchange mode: ECDHE(0), DHE(1), PSK(2), ECDHE-PSK(3), DHE-PSK(4) |
| `tls::group` | uint16 | Groups used in the handshake (as in IANA [registry][iana-tls-supported-groups]) |

##### SSH context names

| name | description |
|------------------------|-----------------------------|
| `ssh::handshake_client`| SSH handshake for client |
| `ssh::handshake_server`| SSH handshake for server |
| `ssh::client_key_sign` | SSH client key proof |
| `ssh::server_key_sign` | SSH server key proof |
beldmit marked this conversation as resolved.
Show resolved Hide resolved
| `ssh::key_exchange` | SSH key exchange |

##### SSH keys

All the keys except `rsa_bits` have `string` type.

| key | description | example |
|---------------------------------|--------------------------------------------------|-------------------------------------------------------------|
| `ssh::ident_string` | Software identity string | `SSH-2.0-OpenSSH_8.8` |
beldmit marked this conversation as resolved.
Show resolved Hide resolved
| `ssh::key_algorithm` | Key used in handshake | `ssh-ed25519` |
| `ssh::rsa_bits` | Key bits (RSA only) | 2048 |
| `ssh::cert_signature_algorithm` | If cert is used, signature algorithm of the cert | `ecdsa-sha2-nistp521` |
| `ssh::kex_algorithm` | Negotiated key exchange algorithm | `curve25519-sha256` |
| `ssh::kex_group` | Group used for key exchange | For DH from moduli - modulus itself. Otherwise group name. |
beldmit marked this conversation as resolved.
Show resolved Hide resolved
| `ssh::c2s_cipher` | Data cipher algorithm | `[email protected]` |
| `ssh::s2c_cipher` | | |
| `ssh::c2s_mac` | Data integrity algorithm | empty string for "implicit" |
beldmit marked this conversation as resolved.
Show resolved Hide resolved
| `ssh::s2c_mac` | | |
| `ssh::c2s_compression` | Data compression algorithm | empty string for "none" |
| `ssh::s2c_compression` | | |

### CBOR based logging format definition

The recommended format of storing events is to use a sequence of
Expand Down