Shared Secret Key Authentication And Encryption: Difference between revisions

From Lustre Wiki
Jump to navigation Jump to search
(adding opensfs contract resources section)
No edit summary
 
Line 1: Line 1:
{| class='wikitable'
|-
!This page collects background and original design references for Shared-Secret Key (SSK) security. For current setup instructions, see [[Lustre Kerberos SSK Authentication]] and the ''Configuring Shared-Secret Key (SSK) Security'' chapter of the [https://doc.lustre.org/lustre_manual.xhtml Lustre Operations Manual].
|}
=== Introduction ===
=== Introduction ===


Shared Key offers
Shared Key, added in Lustre 2.9 ([https://jira.whamcloud.com/browse/LU-3289 LU-3289]), offers:


* Isolation
* Isolation (all SSK flavors)
** Prevents clients from mounting without the shared key
** Prevents clients from mounting without the shared key
** Group and isolate NID ranges to a specific key (with [[UID/GID_Mapping|UID/GID Mapping]])
** Binds a key to a nodemap, so it is accepted only from that nodemap's NID ranges (with [[UID/GID_Mapping|UID/GID Mapping]])


* Message Integrity
* Message Integrity (<code>ska</code>, <code>ski</code>, <code>skpi</code>)
** Prevents man-in-the-middle attacks
** Prevents man-in-the-middle attacks
** Ensure RPCs cannot be altered without detection
** Ensures RPCs cannot be altered without detection. <code>ska</code> covers only non-bulk RPCs; <code>ski</code> and <code>skpi</code> also cover bulk data.


* Privacy
* Privacy (<code>skpi</code> only)
** Prevents eavesdropping
** Prevents eavesdropping
** Encryption of RPCs
** Encrypts RPCs and bulk data


* Ability to choose security flavors between OSS, MDS, MGS, and client nodes, as site policy dictates
* Ability to choose security flavors between OSS, MDS, MGS, and client nodes, as site policy dictates


== Resources ==  
== Resources ==
* [https://jira.hpdd.intel.com/browse/LU-3289 IU Shared Secret Key authentication and encryption (LU-3289)]
* [https://jira.whamcloud.com/browse/LU-3289 IU Shared Secret Key authentication and encryption (LU-3289)]
* [http://wiki.opensfs.org/Contract_SFS-DEV-002 OpenSFS Contract SFS-DEV-002]
* The original OpenSFS Contract SFS-DEV-002 design documents (Shared Key Scope, Architecture, High Level Design, RPC Diagram, and Kerberos Setup Guide) were previously hosted on wiki.opensfs.org but are no longer available online.
** [http://wiki.opensfs.org/File:Shared_keys_scope_v2.pdf Shared Key Scope v2]
* For current setup instructions, see [[Lustre Kerberos SSK Authentication]]. For the reference, see the ''Configuring Shared-Secret Key (SSK) Security'' chapter of the [https://doc.lustre.org/lustre_manual.xhtml Lustre Operations Manual].
** [http://wiki.opensfs.org/File:Shared_keys_architecture.pdf Shared Key Architecture]
** [http://wiki.opensfs.org/File:Shared_keys_HLD.docx Shared Key High Level Design]
** [http://wiki.opensfs.org/File:Shared_keys_RPC_diagram.pdf Shared Key RPC Diagram]
** [http://wiki.opensfs.org/File:Kerberos_setup_guide.pdf Kerberos Setup Guide]


== Presentations ==
== Presentations ==
Line 31: Line 32:


[[Category:Features]]
[[Category:Features]]
[[Category:Security]]

Latest revision as of 08:13, 12 October 2026

This page collects background and original design references for Shared-Secret Key (SSK) security. For current setup instructions, see Lustre Kerberos SSK Authentication and the Configuring Shared-Secret Key (SSK) Security chapter of the Lustre Operations Manual.

Introduction

Shared Key, added in Lustre 2.9 (LU-3289), offers:

  • Isolation (all SSK flavors)
    • Prevents clients from mounting without the shared key
    • Binds a key to a nodemap, so it is accepted only from that nodemap's NID ranges (with UID/GID Mapping)
  • Message Integrity (ska, ski, skpi)
    • Prevents man-in-the-middle attacks
    • Ensures RPCs cannot be altered without detection. ska covers only non-bulk RPCs; ski and skpi also cover bulk data.
  • Privacy (skpi only)
    • Prevents eavesdropping
    • Encrypts RPCs and bulk data
  • Ability to choose security flavors between OSS, MDS, MGS, and client nodes, as site policy dictates

Resources

Presentations