Trident Linux統合キー設定(LUKS)
Linux Unified Key Setup (LUKS) は、ディスク暗号化の仕様です。TridentはLUKSを使用して、ONTAP SANおよびONTAP SAN ECONOMYボリュームに対してボリューム単位のホスト側暗号化を提供し、パスフレーズのローテーションとボリュームの拡張をサポートします。
Tridentでは、LUKSで暗号化されたボリュームでAES-XTS-plain64暗号化およびモードが使用されます(の推奨)"NIST"。
|
|
LUKS暗号化はASA r2システムではサポートされていません。ASAr2システムの詳細については、以下を参照してください。 "ASA R2ストレージシステムの詳細" 。 |
-
ワーカーノードにはcryptsetup 2.1以上(3.0よりも下位)がインストールされている必要があります。詳細については、を参照してください "Gitlab: cryptsetup"。
-
パフォーマンス上の理由から、NetAppでは、ワーカーノードでAdvanced Encryption Standard New Instructions(AES-NI)をサポートすることを推奨しています。AES-NIサポートを確認するには、次のコマンドを実行します。
grep "aes" /proc/cpuinfo
何も返されない場合、お使いのプロセッサはAES-NIをサポートしていません。AES-NIの詳細については、以下を参照してください。 "Intel:Advanced Encryption Standard Instructions(AES-NI)"。
LUKS暗号化を有効にします
ONTAP SANおよびONTAP SANエコノミーボリュームでは、Linux Unified Key Setup(LUKS;Linux統合キーセットアップ)を使用して、ボリューム単位のホスト側暗号化を有効にできます。
-
バックエンド構成でLUKS暗号化属性を定義します。ONTAP SANのバックエンド構成オプションの詳細については、を参照してください "ONTAP のSAN構成オプション"。
{ "storage": [ { "labels": { "luks": "true" }, "zone": "us_east_1a", "defaults": { "luksEncryption": "true" } }, { "labels": { "luks": "false" }, "zone": "us_east_1a", "defaults": { "luksEncryption": "false" } } ] } -
使用
parameters.selectorLUKS暗号化を使用してストレージプールを定義する方法。例:apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: luks provisioner: csi.trident.netapp.io parameters: selector: "luks=true" csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name} csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace} -
LUKSパスフレーズを含むシークレットを作成します。例:
kubectl -n trident create -f luks-pvc1.yaml apiVersion: v1 kind: Secret metadata: name: luks-pvc1 stringData: luks-passphrase-name: A luks-passphrase: secretA
RWX rawブロックボリュームでLUKSを使用する
Trident 26.10以降では、 ReadWriteMany(RWX)アクセスモードを使用して複数のKubernetesノードに接続されたiSCSIベースのrawブロックボリュームで、LUKS暗号化を使用できます。これは、ライブマイグレーション中にソースノードに接続されたままの状態で、宛先ノードにも同じ暗号化ボリュームを接続する必要があるKubeVirt仮想マシンなどのワークロードに役立ちます。
RWX LUKSのサポートは、rawブロックボリュームに限定されます。ファイルシステムモードのRWX LUKSボリュームはサポートされていません。アプリケーションは、復号化されたデータへの同時アクセスを調整する役割を担います。TridentはLUKS処理の調整のみを行います。
LUKS暗号化を有効にしますで説明されているように、バックエンド、StorageClass、およびパスフレーズSecretでLUKSを設定します。次に、 `volumeMode: Block`および `ReadWriteMany`を使用してPVCを作成します:
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: my-rwx-pvc
namespace: my-app
spec:
accessModes:
- ReadWriteMany
volumeMode: Block
storageClassName: san-luks-rwx
resources:
requests:
storage: 10Gi
複数のノード上のポッドは、このPVCをrawブロックデバイスとして接続できます。Tridentは、最初の接続時にデバイスをLUKS2でフォーマットし、後続のノードでは既存の暗号化ボリュームを開きます。パスフレーズのローテーションやボリュームの拡張など、既存のLUKS操作がサポートされています。
TridentがLUKS操作をシリアル化する理由
LUKS2は、暗号化ヘッダーの冗長コピーをブロックデバイスの先頭に格納します。 `cryptsetup`は、読み取り専用のように見えるコマンドの実行中も含め、コピーが異なることを検出した場合にヘッダーを修復できます。そのロック機能はノード固有のものであり、他のノードでの操作を調整することはできません。1つのノードがヘッダーを更新している間に、別のノードが `cryptsetup`を実行すると、2番目のノードがヘッダー修復をトリガーして更新を中断し、ヘッダーを破損させる可能性があります。
同時ヘッダーアクセスを防止するため、Tridentは各RWX LUKSボリュームに対してKubernetesリースを使用します。ノードがボリュームに対して任意の `cryptsetup`コマンドを実行する前に、リースを保持している必要があります。Tridentは、操作が成功したあとにリースを解放します。リースが保持されている間に別のノードが操作を要求した場合、Tridentは再試行可能なエラーを返し、Kubernetesは後で再試行します。異なるボリュームに対する操作は独立しています。
`cryptsetup`操作が失敗した場合、Tridentは意図的にリースを保持し、同じノードのみが再試行できるようにします。理由が `LeaseRetained`の警告イベントに失敗が記録されます。リースは自動的に期限切れにはなりません。管理者は、その保持ノードで `cryptsetup`操作が実行されていないことを確認したあとにのみ、リースを削除する必要があります。復旧手順については、link:rwx-luks-stuck-lease.html["RWX Linux Unified Key Setup (LUKS) ボリュームのリースが停止した状態を修復する"]を参照してください。
ノードが順番にボリュームを開くため、多くの異なるノードでワークロードを開始するには、暗号化されていないボリュームの場合よりも時間がかかる場合があります。Kubernetesは、現在の操作が完了したあとに、一時的なロックエラーを再試行します。ポッドは大規模なスケールアウト中、 `ContainerCreating`に長く留まる場合があります。同一ノード上のワークロードは、単一のオープンデバイスマッピングを共有できます。
制限
LUKSで暗号化されたボリュームは、ONTAP の重複排除と圧縮を利用できません。
LUKSボリュームをインポートするためのバックエンド構成
LUKSボリュームをインポートするには、バックエンドでをに(true`設定する必要があります `luksEncryption。このオプションを指定する `luksEncryption`と、(`false`次の例に示すように、ボリュームがLUKS準拠である(`true`かどうかがTridentに通知されます。
version: 1
storageDriverName: ontap-san
managementLIF: 10.0.0.1
dataLIF: 10.0.0.2
svm: trident_svm
username: admin
password: password
defaults:
luksEncryption: 'true'
spaceAllocation: 'false'
snapshotPolicy: default
snapshotReserve: '10'
LUKSボリュームをインポートするためのPVC設定
LUKSボリュームを動的にインポートするには、 trident.netapp.io/luksEncryption `true`次の例に示すように、アノテーションをに設定し、LUKS対応のストレージクラスをPVCに含めます。
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
name: luks-pvc
namespace: trident
annotations:
trident.netapp.io/luksEncryption: "true"
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
storageClassName: luks-sc
LUKSパスフレーズをローテーションします
LUKSのパスフレーズをローテーションしてローテーションを確認できます。
|
|
パスフレーズは、ボリューム、Snapshot、シークレットで参照されなくなることを確認するまで忘れないでください。参照されているパスフレーズが失われた場合、ボリュームをマウントできず、データが暗号化されたままアクセスできなくなることがあります。 |
LUKSパスフレーズのローテーションは、ボリュームをマウントするポッドが、新しいLUKSパスフレーズの指定後に作成されたときに行われます。新しいPODが作成されると、Tridentはボリューム上のLUKSパスフレーズをシークレット内のアクティブなパスフレーズと比較します。
-
ボリュームのパスフレーズがシークレットでアクティブなパスフレーズと一致しない場合、ローテーションが実行されます。
-
ボリュームのパスフレーズがシークレットのアクティブなパスフレーズと一致する場合は、を参照してください
previous-luks-passphraseパラメータは無視されます。
-
を追加します
node-publish-secret-nameおよびnode-publish-secret-namespaceStorageClassパラメータ。例:apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: csi-san provisioner: csi.trident.netapp.io parameters: trident.netapp.io/backendType: "ontap-san" csi.storage.k8s.io/node-stage-secret-name: luks csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace} csi.storage.k8s.io/node-publish-secret-name: luks csi.storage.k8s.io/node-publish-secret-namespace: ${pvc.namespace} -
ボリュームまたはSnapshotの既存のパスフレーズを特定します。
ボリュームtridentctl -d get volume luks-pvc1 GET http://127.0.0.1:8000/trident/v1/volume/<volumeID> ...luksPassphraseNames:["A"]
スナップショットtridentctl -d get snapshot luks-pvc1 GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID> ...luksPassphraseNames:["A"]
-
ボリュームのLUKSシークレットを更新して、新しいパスフレーズと前のパスフレーズを指定します。確認します
previous-luke-passphrase-nameおよびprevious-luks-passphrase前のパスフレーズと同じにします。apiVersion: v1 kind: Secret metadata: name: luks-pvc1 stringData: luks-passphrase-name: B luks-passphrase: secretB previous-luks-passphrase-name: A previous-luks-passphrase: secretA -
ボリュームをマウントする新しいポッドを作成します。これはローテーションを開始するために必要です。
-
パスフレーズがローテーションされたことを確認します。
ボリュームtridentctl -d get volume luks-pvc1 GET http://127.0.0.1:8000/trident/v1/volume/<volumeID> ...luksPassphraseNames:["B"]
スナップショットtridentctl -d get snapshot luks-pvc1 GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID> ...luksPassphraseNames:["B"]
パスフレーズは、ボリュームとSnapshotに新しいパスフレーズのみが返されたときにローテーションされました。
|
|
たとえば、2つのパスフレーズが返された場合などです `luksPassphraseNames: ["B", "A"]`回転が不完全です。回転を完了するために、新しいポッドをトリガできます。 |
ボリュームの拡張を有効にします
LUKS暗号化ボリューム上でボリューム拡張を有効にできます。
-
を有効にします
CSINodeExpandSecret機能ゲート(ベータ1.25+)。を参照してください "Kubernetes 1.25:CSIボリュームのノードベースの拡張にシークレットを使用します" を参照してください。 -
を追加します
node-expand-secret-nameおよびnode-expand-secret-namespaceStorageClassパラメータ。例:apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: luks provisioner: csi.trident.netapp.io parameters: selector: "luks=true" csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name} csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace} csi.storage.k8s.io/node-expand-secret-name: luks-${pvc.name} csi.storage.k8s.io/node-expand-secret-namespace: ${pvc.namespace} allowVolumeExpansion: true
ストレージのオンライン拡張を開始すると、ドライバに適切なクレデンシャルが渡されます。