introduce IPsec Service in virtio-crypto
v6 cover introduce IPsec Service in virtio-crypto
This series enhances virtio-crypto by adding support for IPsec services. These patches aim to extend the capabilities of virtio-crypto, enabling it to handle IPsec operations efficiently. In addition to standard crypto processing, the IPsec protocol processing is also offloaded to the Crypto device as lookaside operation.
It utilizes new virtio basic facilities, including capability and resource objects. Below is a summary of the changes introduced:
Patch1:
This patch introduces the foundational support for IPsec services within the virtio-crypto framework, outlining the necessary capabilities for IPsec operations.
Patch2:
This patch adds resource objects required for programming IPsec Security Associations (SAs) for both encryption and decryption processes.
Patch3:
This patch includes new opcodes specific to IPsec operations, facilitating the handling of IPsec data requests within the virtio-crypto driver.
Patch4:
This patch specifies the requirements for both the device and the driver to support IPsec operations.
These enhancements are for providing support for IPsec within the virtio-crypto device/driver, improving security and performance for virtualized environments. We believe these additions will significantly benefit users who rely on virtio-crypto for secure data transmission.
v2:
- Addressed the review comments from Matias.
v3:
- Addressed the review comments from Parav Pandit.
v4:
- Introduced COPY_DF, ECN and SA LIFETIME to the SA options.
- Introduced SA lifetime to the SA resource object data structure.
- Set cipher and auth key arrays to fixed sizes.
v5:
- Addressed minor review comments from Parav Pandit.
v6:
- The esn field has been removed from the IPsec SA resource object.
Srujana Challa (4):
virtio-crypto: Add IPsec service operation and Capabilities
virtio-crypto: Add resource objects for IPsec outbound and inbound SAs
virtio-crypto: Add new IPsec opcodes to data request
virtio-crypto: Add device and driver requirements for IPsec operation
device-types/crypto/description.tex | 510 ++++++++++++++++++++- device-types/crypto/device-conformance.tex | 1 + device-types/crypto/driver-conformance.tex | 1 + introduction.tex | 12 + 4 files changed, 519 insertions(+), 5 deletions(-)
Signature · 1 line
2.25.1
RFC PATCH v6 1/4 virtio-crypto: Add IPsec service operation and Capabilities
This commit introduces the IPsec service operation to the Crypto device, enabling offloading of IPsec processing.
Capabilities:
1. IPsec Resource Capability (VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP):
Indicates the device's IPsec resource limits, such as the number of outbound and inbound Security Associations (SAs).
2. IPsec SA Capability (VIRTIO_CRYPTO_IPSEC_SA_CAP): Specifies the supported IPsec modes, along with the supported cryptographic algorithms, authentication algorithms, IPsec options and anti-replay window size.
--- device-types/crypto/description.tex | 174 +++++++++++++++++++++++++++- introduction.tex | 12 ++ 2 files changed, 181 insertions(+), 5 deletions(-)
device-types/crypto/description.tex +169 -5
@@ -2,13 +2,15 @@ \section{Crypto Device}\label{sec:Device Types / Crypto Device} The virtio crypto device is a virtual cryptography device as well as a virtual cryptographic accelerator. The virtio crypto device provides the -following crypto services: CIPHER, MAC, HASH, AEAD and AKCIPHER. Virtio crypto -devices have a single control queue and at least one data queue. Crypto -operation requests are placed into a data queue, and serviced by the -device. Some crypto operation requests are only valid in the context of a -session. The role of the control queue is facilitating control operation +following crypto services: CIPHER, MAC, HASH, AEAD, AKCIPHER and IPSEC. +Virtio crypto devices have a single control queue and at least one data +queue. Crypto operation requests are placed into a data queue, and serviced +by the device. Some crypto operation requests are only valid in the context +of a session. The role of the control queue is facilitating control operation requests. Sessions management is realized with control operation requests. +The crypto device may have administration command interface through which +IPsec service capabilities and resources are configured. \subsection{Device ID}\label{sec:Device Types / Crypto Device / Device ID}
@@ -72,6 +74,8 @@ \subsection{Supported crypto services}\label{sec:Device Types / Crypto Device / #define VIRTIO_CRYPTO_SERVICE_AEAD 3 /* AKCIPHER (Asymmetric Key Cipher) service */ #define VIRTIO_CRYPTO_SERVICE_AKCIPHER 4 +/* IPSEC service */ +#define VIRTIO_CRYPTO_SERVICE_IPSEC 5 \end{lstlisting} The above constants designate bits used to indicate the which of crypto services are
@@ -318,6 +322,20 @@ \subsection{Device Initialization}\label{sec:Device Types / Crypto Device / Devi \item The driver MUST read the supported algorithms based on \field{crypto_services} field. \end{itemize*} +\subsection{Device and driver capabilities}\label{sec:Device Types / Crypto Device / Device and driver capabilities} + +The crypto device has the following capabilities. + +\begin{tabularx}{\textwidth}{ |l||l|X| } +\hline +Identifier & Name & Description \\ +\hline \hline +0x0800 & \hyperref[par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-RESOURCE-CAP]{VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP} & IPsec resource capability \\ +\hline +0x0801 & \hyperref[par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP]{VIRTIO_CRYPTO_IPSEC_SA_CAP} & IPsec Security Association(SA) capability \\ +\hline +\end{tabularx} + \subsection{Device Operation}\label{sec:Device Types / Crypto Device / Device Operation} The operation of a virtio crypto device is driven by requests placed on the virtqueues.
@@ -1872,3 +1890,149 @@ \subsubsection{AKCIPHER Service Operation}\label{sec:Device Types / Crypto Devic \item VIRTIO_CRYPTO_ERR if any failure not mentioned above occurs. \end{itemize*} \end{itemize*} + +\subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / Device Operation / IPSEC Service Operation} + +A crypto device can support the processing of IPsec protocol operations. +In addition to standard crypto processing, the IPsec protocol operations +are also handled by the crypto device as a lookaside operation. + +IPsec Inbound processing: The device performs decryption, authentication, +integrity checking and remove additional headers, including tunnel header if +in tunnel mode, as well as the ESP/AH header on the given packet(See \hyperref[intro:IPSEC]{IPSEC} RFC). +The resulting packet contains only the plain data. + +IPsec Outbound processing: The device performs encryption, attach ICV, +update/add IP header and add ESP/AH header/trailer. The resulting packet +contains encrypted data along with the IPsec header and trailer. + +A crypto device can support number of IPsec SAs, allowing it to manage multiple secure +connections simultaneously. + +The device and the driver indicate IPsec SA resource limits using the +VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP capability specifying the limits on the number of +IPsec outbound and inbound SA resource objects. +The VIRTIO_CRYPTO_IPSEC_SA_CAP capability specifies the IPsec protocol capabilities +supported by the device. The driver indicates the IPsec parameters by setting +VIRTIO_CRYPTO_IPSEC_SA_CAP capability prior to adding any resource object. + +The driver controls the IPsec SA resource object using administration commands described in +\ref{sec:Basic Facilities of a Virtio Device / Device groups / Group administration commands / Device resource objects}. + +\paragraph{Device and driver capabilities} +\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities} + +\subparagraph{VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP} +\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-RESOURCE-CAP} + +The VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP capability indicates the IPsec SA resource limits. +\field{cap_specific_data} is in the format +\field{struct virtio_crypto_ipsec_resource_cap}. + +\begin{lstlisting} +struct virtio_crypto_ipsec_resource_cap { + le32 inb_sa_limit; + le32 outb_sa_limit; +}; +\end{lstlisting} + +\field{inb_sa_limit}, and \field{outb_sa_limit} denote the maximum number of IPsec +security Associations (SAs) that can be utilized for IPsec inbound and outbound processing, +respectively, which the device is capable of creating. + +\subparagraph{VIRTIO_CRYPTO_IPSEC_SA_CAP} +\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP} + +The VIRTIO_CRYPTO_IPSEC_SA_CAP capability lists the supported IPsec modes along with +the supported cryptographic, authentication algorithms and anti-replay window size for +each IPsec mode. +\field{cap_specific_data} is in the format \field{struct virtio_crypto_ipsec_sa_cap_data}. + +\begin{lstlisting}[label={lst:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / virtio-crypto-ipsec-mode-cap}] +struct virtio_crypto_ipsec_mode_cap { + u8 mode; + u8 reserved[3]; + le32 max_replay_win_sz; + le32 options; + le32 reserved1; + le64 cipher_algo; + le64 hmac_algo; + le32 aead_algo; + le32 max_cipher_key_len; + le32 max_auth_key_len; +}; + +struct virtio_crypto_ipsec_sa_cap_data { + u8 count; + u8 reserved[7]; + struct virtio_crypto_ipsec_mode_cap cap_mode[]; +}; +\end{lstlisting} + +\field{count} indicates number of valid entries in the \field{mode} array. +\field{cap_mode[]} is an array of supported IPsec modes. Within each array entry: + +\field{mode} specifies the IPsec mode, as defined in table +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes}. +\field{max_replay_win_sz} specifies the maximum anti-replay window size the device supports. +This field is applicable only for inbound operation. + +\field{options} Each bit indicates the IPsec protocol options supported by the device, as defined in table +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options}. + +\field{cipher_algo} CIPHER algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / CIPHER services}. + +\field{hmac_algo} HMAC algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / MAC services}. + +\field{aead_algo} AEAD algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / AEAD services}. + +\field{max_cipher_key_len} is the maximum length of cipher key supported by the device. + +\field{max_auth_key_len} is the maximum length of authentication key supported by the device. + +\begin{table}[H] +\caption{IPsec Modes} +\label{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes} +\begin{tabularx}{\textwidth}{ |l|X|X| } +\hline +Type & Name & Description \\ +\hline \hline +0x0 & - & Reserved \\ +\hline +0x1 & VIRTIO_CRYPTO_IPSEC_MODE_ESP_TUNNEL & IPsec ESP protocol in tunnel mode \\ +\hline +0x2 & VIRTIO_CRYPTO_IPSEC_MODE_ESP_TRANSPORT & IPsec ESP protocol in transport mode \\ +\hline +0x3 & VIRTIO_CRYPTO_IPSEC_MODE_AH_TUNNEL & IPsec AH protocol in tunnel mode \\ +\hline +0x4 & VIRTIO_CRYPTO_IPSEC_MODE_AH_TRANSPORT & IPsec AH protocol in transport mode \\ +\hline +\end{tabularx} +\end{table} + +See \hyperref[intro:IPSEC]{IPSEC} for more information on tunnel and transport modes in ESP/AH IPsec processing. + +\begin{table}[H] +\caption{IPsec Options} +\label{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options} +\begin{tabularx}{\textwidth}{ |l|X|X| } +\hline +Bit Number & Name & Description \\ +\hline \hline +0 & VIRTIO_CRYPTO_IPSEC_ESN & Specifies whether extended sequence number is supported, as described in \hyperref[intro:ESN]{ESN}\\ +\hline +1 & VIRTIO_CRYPTO_IPSEC_UDP_ENCAP & Specifies whether udp encapsulation is supported, as described in + \hyperref[intro:UDP-Encapsulation]{UDP Encapsulation}, applicable only for ESP IPsec processing \\ +\hline +2 & VIRTIO_CRYPTO_IPSEC_COPY_DSCP & Specifies whether copy dscp is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +3 & VIRTIO_CRYPTO_IPSEC_DEC_TTL & Specifies whether decrementing the time to live is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +4 & VIRTIO_CRYPTO_IPSEC_COPY_DF & Specifies whether copy Don't Fragment bit is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +5 & VIRTIO_CRYPTO_IPSEC_ECN & Specifies whether copy Explicit Congestion Notification is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +6 & VIRTIO_CRYPTO_IPSEC_SA_LIFETIME & Specifies whether SA lifetime feature is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +\end{tabularx} +\end{table}
introduction.tex +12 -0
@@ -162,6 +162,18 @@ \section{Normative References}\label{sec:Normative References} \phantomsection\label{intro:TCP-Header-Format}\textbf{[TCP Header Format]} & TCP Header Format \newline\url{https://www.rfc-editor.org/rfc/rfc9293#name-header-format}\\ + \phantomsection\label{intro:IPSEC}\textbf{[IPSEC]} & + IPsec Protocol + \newline\url{https://www.rfc-editor.org/rfc/rfc4301}\\ + \phantomsection\label{intro:ESP}\textbf{[ESP]} & + IPsec ESP + \newline\url{https://www.rfc-editor.org/rfc/rfc4303}\\ + \phantomsection\label{intro:ESN}\textbf{[ESN]} & + IPsec ESN + \newline\url{https://www.rfc-editor.org/rfc/rfc4304}\\ + \phantomsection\label{intro:UDP-Encapsulation}\textbf{[UDP Encapsulation]} & + IPsec UDP Encapsulation + \newline\url{https://www.rfc-editor.org/rfc/rfc3948}\\ \phantomsection\label{intro:CAN}\textbf{[CAN]} & ISO 11898-1:2015 Road vehicles -- Controller area network (CAN) -- Part 1: Data link layer and physical signalling\\ \phantomsection\label{intro:rfc8174}\textbf{[RFC8174]} &
Signature · 1 line
2.25.1
RE: [PATCH RFC v6 1/4] virtio-crypto: Add IPsec service operation and Capabilities
Quoted 335 lines
From: Srujana Challa <[email protected]>
Sent: Thursday, April 24, 2025 3:01 PMThis commit introduces the IPsec service operation to the Crypto device, enabling offloading of IPsec processing.
Capabilities:
1. IPsec Resource Capability (
VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP):
Indicates the device's IPsec resource limits, such as the number of outbound and inbound Security Associations (SAs).
2. IPsec SA Capability (VIRTIO_CRYPTO_IPSEC_SA_CAP): Specifies the supported IPsec modes, along with the supported cryptographic algorithms, authentication algorithms, IPsec options and anti-replay window size.Signed-off-by Srujana Challa <[email protected]>--- device-types/crypto/description.tex | 174 +++++++++++++++++++++++++++- introduction.tex | 12 ++ 2 files changed, 181 insertions(+), 5 deletions(-)device- renamed from device-types/crypto/description.tex +0
-0types/crypto/description.tex
index e053cc7..f4978f0 100644device-types/crypto/description.tex +0
-0@@ -2,13 +2,15 @@ \section{Crypto Device}\label{sec:Device Types / Crypto Device} The virtio crypto device is a virtual cryptography device as well as a virtualcryptographic accelerator. The virtio crypto device provides the -following crypto services: CIPHER, MAC, HASH, AEAD and AKCIPHER. Virtio crypto - devices have a single control queue and at least one data queue. Crypto - operation requests are placed into a data queue, and serviced by the -device. Some crypto operation requests are only valid in the context of a -session. The role of the control queue is facilitating control operation
device-types/crypto/description.tex +8
-0+following crypto services: CIPHER, MAC, HASH, AEAD, AKCIPHER and IPSEC. +Virtio crypto devices have a single control queue and at least one data +queue. Crypto operation requests are placed into a data queue, and +serviced by the device. Some crypto operation requests are only valid +in the context of a session. The role of the control queue is +facilitating control operation requests. Sessions management is realized with control operation requests. +The crypto device may have administration command interface through +which IPsec service capabilities and resources are configured. \subsection{Device ID}\label{sec:Device Types / Crypto Device / Device ID}@@ -72,6 +74,8 @@ \subsection{Supported crypto services}\label{sec:DeviceTypes / Crypto Device /
#defineVIRTIO_CRYPTO_SERVICE_AEAD3
/* AKCIPHER (Asymmetric Key Cipher) service */ #defineVIRTIO_CRYPTO_SERVICE_AKCIPHER4device-types/crypto/description.tex +2
-0+/* IPSEC service */ +#define VIRTIO_CRYPTO_SERVICE_IPSEC 5 \end{lstlisting} The above constants designate bits used to indicate the which of cryptoservices are @@ -318,6 +322,20 @@ \subsection{Device Initialization}\label{sec:Device Types / Crypto Device / Devi \item The driver MUST read the supported algorithms based on \field{crypto_services} field.
\end{itemize*}+\subsection{Device and driver capabilities}\label{sec:Device Types /
device-types/crypto/description.tex +9
-0+Crypto Device / Device and driver capabilities} + +The crypto device has the following capabilities. + +\begin{tabularx}{\textwidth}{ |l||l|X| } \hline Identifier & Name & +Description \\ \hline \hline +0x0800 & \hyperref[par:Device Types / Crypto Device / Device Operation +/ IPsec Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-RESOURCE-CAP]{VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP} &
device-types/crypto/description.tex +6
-0+IPsec resource capability \\ \hline +0x0801 & \hyperref[par:Device Types / Crypto Device / Device Operation +/ IPsec Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-SA-CAP]{VIRTIO_CRYPTO_IPSEC_SA_CAP} & IPsec +Security Association(SA) capability \\ \hline \end{tabularx} + \subsection{Device Operation}\label{sec:Device Types / Crypto Device /Device Operation}
The operation of a virtio crypto device is driven by requests placed on the
virtqueues.device-types/crypto/description.tex +0
-0@@ -1872,3 +1890,149 @@ \subsubsection{AKCIPHER ServiceOperation}\label{sec:Device Types / Crypto Devic \item
VIRTIO_CRYPTO_ERRif any failure not mentioned above occurs.
\end{itemize*}
\end{itemize*}device-types/crypto/description.tex +11
-0+ +\subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto +Device / Device Operation / IPSEC Service Operation} + +A crypto device can support the processing of IPsec protocol operations. +In addition to standard crypto processing, the IPsec protocol +operations are also handled by the crypto device as a lookaside operation. + +IPsec Inbound processing: The device performs decryption, +authentication, integrity checking and remove additional headers, +including tunnel header if in tunnel mode, as well as the ESP/AH header onthe given
packet(See \hyperref[intro:IPSEC]{IPSEC} RFC).device-types/crypto/description.tex +15
-0+The resulting packet contains only the plain data. + +IPsec Outbound processing: The device performs encryption, attach ICV, +update/add IP header and add ESP/AH header/trailer. The resulting +packet contains encrypted data along with the IPsec header and trailer. + +A crypto device can support number of IPsec SAs, allowing it to manage +multiple secure connections simultaneously. + +The device and the driver indicate IPsec SA resource limits using the +VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP capability specifying the limits on +the number of IPsec outbound and inbound SA resource objects. +The VIRTIO_CRYPTO_IPSEC_SA_CAP capability specifies the IPsec protocol +capabilities supported by the device. The driver indicates the IPsec +parameters by setting VIRTIO_CRYPTO_IPSEC_SA_CAP capability prior toadding any resource object.
device-types/crypto/description.tex +3
-0+ +The driver controls the IPsec SA resource object using administration +commands described in \ref{sec:Basic Facilities of a Virtio Device / Devicegroups / Group administration commands / Device resource objects}.
device-types/crypto/description.tex +11
-0+ +\paragraph{Device and driver capabilities} \label{par:Device Types / +Crypto Device / Device Operation / IPsec Service Operation / Device and +driver capabilities} + +\subparagraph{VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP} +\label{par:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-RESOURCE-CAP} + +The VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP capability indicates the IPsec SAresource limits.
+\field{cap_specific_data} is in the format \field{structdevice-types/crypto/description.tex +12
-0+virtio_crypto_ipsec_resource_cap}. + +\begin{lstlisting} +struct virtio_crypto_ipsec_resource_cap { + le32 inb_sa_limit; + le32 outb_sa_limit; +}; +\end{lstlisting} + +\field{inb_sa_limit}, and \field{outb_sa_limit} denote the maximum +number of IPsec security Associations (SAs) that can be utilized for +IPsec inbound and outbound processing, respectively, which the device iscapable of creating.
device-types/crypto/description.tex +10
-0+ +\subparagraph{VIRTIO_CRYPTO_IPSEC_SA_CAP} +\label{par:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-SA-CAP} + +The VIRTIO_CRYPTO_IPSEC_SA_CAP capability lists the supported IPsec +modes along with the supported cryptographic, authentication algorithms +and anti-replay window size for each IPsec mode. +\field{cap_specific_data} is in the format \field{struct
virtio_crypto_ipsec_sa_cap_data}.device-types/crypto/description.tex +3
-0+ +\begin{lstlisting}[label={lst:Device Types / Crypto Device / Device +Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / virtio-crypto-ipsec-mode-cap}] struct
virtio_crypto_ipsec_mode_cap{device-types/crypto/description.tex +20
-0+ u8 mode; + u8 reserved[3]; + le32 max_replay_win_sz; + le32 options; + le32 reserved1; + le64 cipher_algo; + le64 hmac_algo; + le32 aead_algo; + le32 max_cipher_key_len; + le32 max_auth_key_len; +}; + +struct virtio_crypto_ipsec_sa_cap_data { + u8 count; + u8 reserved[7]; + struct virtio_crypto_ipsec_mode_cap cap_mode[]; }; +\end{lstlisting} + +\field{count} indicates number of valid entries in the \field{mode} array. +\field{cap_mode[]} is an array of supported IPsec modes. Within each arrayentry:
+
+\field{mode} specifies the IPsec mode, as defined in table +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes}.
+\field{max_replay_win_sz} specifies the maximum anti-replay window size the device supports.device-types/crypto/description.tex +4
-0+This field is applicable only for inbound operation. + +\field{options} Each bit indicates the IPsec protocol options supported +by the device, as defined in table \ref{table:Device Types / Crypto Device /Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options}.
+
+\field{cipher_algo} CIPHER algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / CIPHER services}.
+
+\field{hmac_algo} HMAC algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / MAC services}.
+
+\field{aead_algo} AEAD algorithms mask, see \ref{sec:Device Types / Crypto Device / Supported crypto services / AEAD services}.
+
+\field{max_cipher_key_len} is the maximum length of cipher key supported by the device.
+
+\field{max_auth_key_len} is the maximum length of authentication key supported by the device.device-types/crypto/description.tex +12
-0+ +\begin{table}[H] +\caption{IPsec Modes} +\label{table:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes} \begin{tabularx}{\textwidth}{ +|l|X|X| } \hline Type & Name & Description \\ \hline \hline +0x0 & - & Reserved \\ +\hline +0x1 & VIRTIO_CRYPTO_IPSEC_MODE_ESP_TUNNEL & IPsec ESP protocol in +tunnel mode \\ \hline +0x2 & VIRTIO_CRYPTO_IPSEC_MODE_ESP_TRANSPORT & IPsec ESP protocolin
+transport mode \\ \hline
+0x3 &VIRTIO_CRYPTO_IPSEC_MODE_AH_TUNNEL& IPsec AH protocol in tunnel
+mode \\ \hline
+0x4 &VIRTIO_CRYPTO_IPSEC_MODE_AH_TRANSPORT& IPsec AH protocol indevice-types/crypto/description.tex +3
-0+transport mode \\ \hline \end{tabularx} \end{table} + +See \hyperref[intro:IPSEC]{IPSEC} for more information on tunnel andtransport modes in ESP/AH IPsec processing.
device-types/crypto/description.tex +11
-0+ +\begin{table}[H] +\caption{IPsec Options} +\label{table:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options} +\begin{tabularx}{\textwidth}{ |l|X|X| } \hline Bit Number & Name & +Description \\ \hline \hline +0 & VIRTIO_CRYPTO_IPSEC_ESN & Specifies whether extended sequence +number is supported, as described in \hyperref[intro:ESN]{ESN}\\ \hline +1 & VIRTIO_CRYPTO_IPSEC_UDP_ENCAP & Specifies whether udpencapsulation is supported, as described in
device-types/crypto/description.tex +9
-0+ +\hyperref[intro:UDP-Encapsulation]{UDP Encapsulation}, applicable only +for ESP IPsec processing \\ \hline +2 & VIRTIO_CRYPTO_IPSEC_COPY_DSCP & Specifies whether copy dscp is +supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ \hline +3 & VIRTIO_CRYPTO_IPSEC_DEC_TTL & Specifies whether decrementing the +time to live is supported, as described in +\hyperref[intro:IPSEC]{IPSEC} \\ \hline +4 & VIRTIO_CRYPTO_IPSEC_COPY_DF & Specifies whether copy Don'tFragment
device-types/crypto/description.tex +8
-0+bit is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline +5 & VIRTIO_CRYPTO_IPSEC_ECN & Specifies whether copy Explicit +Congestion Notification is supported, as described in +\hyperref[intro:IPSEC]{IPSEC} \\ \hline +6 & VIRTIO_CRYPTO_IPSEC_SA_LIFETIME & Specifies whether SA lifetime +feature is supported, as described in \hyperref[intro:IPSEC]{IPSEC} \\ +\hline \end{tabularx} \end{table}introduction.tex +0
-0@@ -162,6 +162,18 @@ \section{Normative References}\label{sec:Normative References} \phantomsection\label{intro:TCP-Header-Format}\textbf{[TCP HeaderFormat]} &
TCP Header Format\newline\url{https://nam11.safelinks.protection.outlook.com/?url=htt
ps%3A%2F%2Fwww.rfc-editor.org%2Frfc%2Frfc9293%23name-header- format&data=05%7C02%7Cparav%40nvidia.com%7C3b8e54c5374348fbea170 8dd8312e037%7C43083d15727340c1b7db39efd9ccc17a%7C0%7C0%7C63881 0839328325483%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydW UsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D% 3D%7C0%7C%7C%7C&sdata=knNerVkUCIQXzImA9o0526SQ6auhXYeD4RsOzrq asJ0%3D&reserved=0}\\introduction.tex +3
-0+ \phantomsection\label{intro:IPSEC}\textbf{[IPSEC]} & + IPsec Protocol +\newline\url{https://nam11.safelinks.protection.outlook.com/?url=htt
ps%3A%2F%2Fwww.rfc- editor.org%2Frfc%2Frfc4301&data=05%7C02%7Cparav%40nvidia.com%7C3b8 e54c5374348fbea1708dd8312e037%7C43083d15727340c1b7db39efd9ccc17a %7C0%7C0%7C638810839328345601%7CUnknown%7CTWFpbGZsb3d8eyJFb XB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWF pbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=pt1JOEttI%2Bojz%2FdtElW Zu9e6%2BA276TM27Ouz%2Berpsq0%3D&reserved=0}\\introduction.tex +3
-0+ \phantomsection\label{intro:ESP}\textbf{[ESP]} & + IPsec ESP +\newline\url{https://nam11.safelinks.protection.outlook.com/?url=htt
ps%3A%2F%2Fwww.rfc- editor.org%2Frfc%2Frfc4303&data=05%7C02%7Cparav%40nvidia.com%7C3b8 e54c5374348fbea1708dd8312e037%7C43083d15727340c1b7db39efd9ccc17a %7C0%7C0%7C638810839328358078%7CUnknown%7CTWFpbGZsb3d8eyJFb XB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWF pbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=pH93zkAjlMdk2m5YVAtu5 xPmfHE5x%2BlEFupefu1Y5Xk%3D&reserved=0}\\introduction.tex +3
-0+ \phantomsection\label{intro:ESN}\textbf{[ESN]} & + IPsec ESN +\newline\url{https://nam11.safelinks.protection.outlook.com/?url=htt
ps%3A%2F%2Fwww.rfc- editor.org%2Frfc%2Frfc4304&data=05%7C02%7Cparav%40nvidia.com%7C3b8 e54c5374348fbea1708dd8312e037%7C43083d15727340c1b7db39efd9ccc17a %7C0%7C0%7C638810839328370013%7CUnknown%7CTWFpbGZsb3d8eyJFb XB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWF pbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=go5pd86ZwdMI9hZIqxcYc RVDEQo97prGrV%2FLgl%2B49H0%3D&reserved=0}\\introduction.tex +1
-0+ \phantomsection\label{intro:UDP-Encapsulation}\textbf{[UDPEncapsulation]} &
introduction.tex +4
-0+ IPsec UDP Encapsulation + +\newline\url{https://nam11.safelinks.protection.outlook.com/?url=https% +3A%2F%2Fwww.rfc-editor.org%2Frfc%2Frfc3948&data=05%7C02%7Cparav%40nvidi +a.com%7C3b8e54c5374348fbea1708dd8312e037%7C43083d15727340c1b7d
b39efd9cc+c17a%7C0%7C0%7C638810839328381738%7CUnknown%7CTWFpbGZsb3d8 eyJFbXB0eU1hc +GkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIld UIjoy +fQ%3D%3D%7C0%7C%7C%7C&sdata=KklJ0Qbwszyi3yRXMW77sz7YkiJN76Gtt Y7Xetxncto
+%3D&reserved=0}\\
\phantomsection\label{intro:CAN}\textbf{[CAN]} &
Quoted 5 lines
ISO 11898-1:2015 Road vehicles -- Controller area network (CAN) -- Part 1:Data link layer and physical signalling\\
\phantomsection\label{intro:rfc8174}\textbf{[RFC8174]} &
--
2.25.1
RFC PATCH v6 2/4 virtio-crypto: Add resource objects for IPsec outbound and inbound SAs
In reply to Srujana ChallaThis commit introduces resource objects to enable the driver/device to create IPsec Security Associations (SAs) for both inbound and outbound directions.
The IPsec SA objects include essential parameters required for packet outbound and inbound processing, such as SPI, tunnel headers, IPsec mode, IPsec options and cipher/authentication specific data.
--- device-types/crypto/description.tex | 155 ++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+)
device-types/crypto/description.tex +155 -0
@@ -336,6 +336,20 @@ \subsection{Device and driver capabilities}\label{sec:Device Types / Crypto Devi \hline \end{tabularx} +\subsection{Device resource objects}\label{sec:Device Types / Crypto Device / Device resource objects} + +The crypto device has the following resource objects. + +\begin{tabularx}{\textwidth}{ |l||l|X| } +\hline +type & Name & Description \\ +\hline \hline +0x0200 & \hyperref[par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA]{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA} & IPsec outbound SA resource object \\ +\hline +0x0201 & \hyperref[par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-INBOUND-SA]{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA} & IPsec inbound SA resource object \\ +\hline +\end{tabularx} + \subsection{Device Operation}\label{sec:Device Types / Crypto Device / Device Operation} The operation of a virtio crypto device is driven by requests placed on the virtqueues.
@@ -2036,3 +2050,144 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / \hline \end{tabularx} \end{table} + +\paragraph{Resource objects} +\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects} + +\subparagraph{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA}\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA} + +A driver can have outbound SAs between 0 and \field{outb_sa_limit}, as specified by the +capability VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the IPsec outbound SA resource object +\field{resource_obj_specific_data} is in the format +\field{struct virtio_crypto_resource_obj_ipsec_sa_256b_key}. + +\begin{lstlisting} +struct in_addr { + le32 s_addr; +}; + +struct in6_addr { + u8 s6_u8[16]; +}; + +struct virtio_crypto_ipsec_tunnel_param { + /* Tunnel type: IPv4 or IPv6 */ + u8 type; + u8 reserved[3]; + union { + /* IPv4 tunnel header parameters */ + struct { + /* IPv4 source address */ + struct in_addr src_ip; + /* IPv4 destination address */ + struct in_addr dst_ip; + /* IPv4 Differentiated Services Code Point */ + u8 dscp; + /* IPv4 Don't Fragment bit */ + u8 df; + /* IPv4 Time To Live */ + u8 ttl; + u8 reserved1; + } ipv4; + /* IPv6 tunnel header parameters */ + struct { + /* IPv6 source address */ + struct in6_addr src_addr; + /* IPv6 destination address */ + struct in6_addr dst_addr; + /* IPv6 flow label */ + le32 flabel; + /* IPv6 hop limit */ + u8 hlimit; + /* IPv6 Differentiated Services Code Point */ + u8 dscp; + u8 reserved2[2]; + } ipv6; + }; +}; + +struct virtio_crypto_ipsec_lifetime { + le64 packets_soft_limit; + le64 bytes_soft_limit; + le64 packets_hard_limit; + le64 bytes_hard_limit; +}; + +struct virtio_crypto_resource_obj_ipsec_sa_256b_key { + u8 mode; + u8 direction; + u8 reserved[2]; + le32 obj_id; + le32 spi; + le32 salt; + le64 options; + struct virtio_crypto_ipsec_tunnel_param param; + le16 udp_sport; + le16 udp_dport; + le32 replay_win_sz; + le64 cipher_algo; + struct { + le16 length; + le16 reserved1; + u8 data[32]; + } cipher_key; + le64 auth_algo; + struct { + le16 length; + le16 reserved2; + u8 data[32]; + } auth_key; + struct virtio_crypto_ipsec_lifetime life; +} +\end{lstlisting} + +\field{mode} specifies the mode of the IPsec SA, see +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes}. + +\field{direction} specifies IPsec SA direction. +\field{obj_id} specifies the object id of the SA that can be used to retrieve +driver-defined data associated with the IPsec SA. +\field{spi} is the Security Parameter Index(SPI) used to uniquely identify the IPsec SA. +\field{salt} is the 32 bit salt value used in the cryptographic operations. + +\field{options} specifies the Options for configuring the IPsec SA, see +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options}. + +\field{param} specifies the parameters for IPsec tunnel mode. +\field{udp_sport} is the source port for UDP encapsulation. +\field{udp_dport} is the destination port for UDP encapsulation. +\field{replay_win_sz} is the anti-replay window size to enable sequence replay attack +handling, replay checking is disabled if the window size is 0. + +\field{cipher_algo} is the cipher algorithm identifier +see \ref{sec:Device Types / Crypto Device / Supported crypto services / CIPHER services} +\field{cipher_key} specifies the cipher key and its length. +\field{auth_algo} is the Authentication algorithm identifier +\field{auth_key} specifies the authentication key data and its length. +\field{life} configures soft and hard lifetime of an IPsec SA. The Lifetime of +an IPsec SA specifies the maximum number of packets or bytes that can be processed. +IPsec operations starts failing once any hard limit is reached. Soft limits generate +a warning status when the SA is approaching its hard lifetime limits. + +\begin{table}[H] +\caption{IPsec Direction} +\label{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA / IPsec Direction} +\begin{tabularx}{\textwidth}{ |l|X|X| } +\hline +Type & Name & Description \\ +\hline \hline +0x0 & - & Reserved \\ +\hline +0x1 & VIRTIO_CRYPTO_IPSEC_DIR_OUTBOUND & IPsec direction outbound \\ +\hline +0x2 & VIRTIO_CRYPTO_IPSEC_DIR_INBOUND & IPsec direction inbound \\ +\hline +\end{tabularx} +\end{table} + +\subparagraph{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA}\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-INBOUND-SA} + +A driver can have inbound SAs between 0 and \field{inb_sa_limit}, as specified by the +capability VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the IPsec inbound SA resource object +\field{resource_obj_specific_data} is in the format +\field{struct virtio_crypto_resource_obj_ipsec_sa}.
Signature · 1 line
2.25.1
RE: [PATCH RFC v6 2/4] virtio-crypto: Add resource objects for IPsec outbound and inbound SAs
Quoted 204 lines
From: Srujana Challa <[email protected]>
Sent: Thursday, April 24, 2025 3:01 PMThis commit introduces resource objects to enable the driver/device to create IPsec Security Associations (SAs) for both inbound and outbound directions.
The IPsec SA objects include essential parameters required for packet outbound and inbound processing, such as SPI, tunnel headers, IPsec mode, IPsec options and cipher/authentication specific data.
Signed-off-by Srujana Challa <[email protected]>--- device-types/crypto/description.tex | 155 ++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+)device- renamed from device-types/crypto/description.tex +0
-0types/crypto/description.tex
index f4978f0..544ac18 100644device-types/crypto/description.tex +10
-0@@ -336,6 +336,20 @@ \subsection{Device and driver capabilities}\label{sec:Device Types / Crypto Devi \hline \end{tabularx} +\subsection{Device resource objects}\label{sec:Device Types / Crypto +Device / Device resource objects} + +The crypto device has the following resource objects. + +\begin{tabularx}{\textwidth}{ |l||l|X| } \hline type & Name & +Description \\ \hline \hline +0x0200 & \hyperref[par:Device Types / Crypto Device / Device Operation +/ IPsec Service Operation / Resource objects / +VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA]{VIRTIO_CRYPTO_RESOURCE_OB
device-types/crypto/description.tex +4
-0+J_IPSEC_OUTBOUND_SA} & IPsec outbound SA resource object \\ \hline +0x0201 & \hyperref[par:Device Types / Crypto Device / Device Operation +/ IPsec Service Operation / Resource objects / +VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-INBOUND-SA]{VIRTIO_CRYPTO_RESOURCE_OBJ
device-types/crypto/description.tex +3
-0+_IPSEC_INBOUND_SA} & IPsec inbound SA resource object \\ \hline +\end{tabularx} + \subsection{Device Operation}\label{sec:Device Types / Crypto Device /Device Operation}
The operation of a virtio crypto device is driven by requests placed on the
virtqueues.device-types/crypto/description.tex +6
-0@@ -2036,3 +2050,144 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / \hline \end{tabularx} \end{table} + +\paragraph{Resource objects} +\label{par:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Resource objects} + +\subparagraph{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA}\label{par:D
device-types/crypto/description.tex +89
-0+evice Types / Crypto Device / Device Operation / IPsec Service +Operation / Resource objects / +VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA} + +A driver can have outbound SAs between 0 and \field{outb_sa_limit}, as +specified by the capability VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the +IPsec outbound SA resource object \field{resource_obj_specific_data} is +in the format \field{struct virtio_crypto_resource_obj_ipsec_sa_256b_key}. + +\begin{lstlisting} +struct in_addr { + le32 s_addr; +}; + +struct in6_addr { + u8 s6_u8[16]; +}; + +struct virtio_crypto_ipsec_tunnel_param { + /* Tunnel type: IPv4 or IPv6 */ + u8 type; + u8 reserved[3]; + union { + /* IPv4 tunnel header parameters */ + struct { + /* IPv4 source address */ + struct in_addr src_ip; + /* IPv4 destination address */ + struct in_addr dst_ip; + /* IPv4 Differentiated Services Code Point */ + u8 dscp; + /* IPv4 Don't Fragment bit */ + u8 df; + /* IPv4 Time To Live */ + u8 ttl; + u8 reserved1; + } ipv4; + /* IPv6 tunnel header parameters */ + struct { + /* IPv6 source address */ + struct in6_addr src_addr; + /* IPv6 destination address */ + struct in6_addr dst_addr; + /* IPv6 flow label */ + le32 flabel; + /* IPv6 hop limit */ + u8 hlimit; + /* IPv6 Differentiated Services Code Point */ + u8 dscp; + u8 reserved2[2]; + } ipv6; + }; +}; + +struct virtio_crypto_ipsec_lifetime { + le64 packets_soft_limit; + le64 bytes_soft_limit; + le64 packets_hard_limit; + le64 bytes_hard_limit; +}; + +struct virtio_crypto_resource_obj_ipsec_sa_256b_key { + u8 mode; + u8 direction; + u8 reserved[2]; + le32 obj_id; + le32 spi; + le32 salt; + le64 options; + struct virtio_crypto_ipsec_tunnel_param param; + le16 udp_sport; + le16 udp_dport; + le32 replay_win_sz; + le64 cipher_algo; + struct { + le16 length; + le16 reserved1; + u8 data[32]; + } cipher_key; + le64 auth_algo; + struct { + le16 length; + le16 reserved2; + u8 data[32]; + } auth_key; + struct virtio_crypto_ipsec_lifetime life; } \end{lstlisting} + +\field{mode} specifies the mode of the IPsec SA, see \ref{table:Device +Types / Crypto Device / Device Operation / IPsec Service Operation / Deviceand driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Modes}.
device-types/crypto/description.tex +5
-0+ +\field{direction} specifies IPsec SA direction. +\field{obj_id} specifies the object id of the SA that can be used to +retrieve driver-defined data associated with the IPsec SA. +\field{spi} is the Security Parameter Index(SPI) used to uniquely identify theIPsec SA.
+\field{salt} is the 32 bit salt value used in the cryptographic operations. +
+\field{options} specifies the Options for configuring the IPsec SA, see +\ref{table:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Device and driver capabilities / VIRTIO-CRYPTO-IPSEC-SA-CAP / IPsec Options}.device-types/crypto/description.tex +14
-0+ +\field{param} specifies the parameters for IPsec tunnel mode. +\field{udp_sport} is the source port for UDP encapsulation. +\field{udp_dport} is the destination port for UDP encapsulation. +\field{replay_win_sz} is the anti-replay window size to enable sequence +replay attack handling, replay checking is disabled if the window size is 0. + +\field{cipher_algo} is the cipher algorithm identifier see +\ref{sec:Device Types / Crypto Device / Supported crypto services / +CIPHER services} \field{cipher_key} specifies the cipher key and its length. +\field{auth_algo} is the Authentication algorithm identifier +\field{auth_key} specifies the authentication key data and its length. +\field{life} configures soft and hard lifetime of an IPsec SA. The +Lifetime of an IPsec SA specifies the maximum number of packets or bytesthat can be processed.
device-types/crypto/description.tex +2
-0+IPsec operations starts failing once any hard limit is reached. Soft +limits generate a warning status when the SA is approaching its hard lifetimelimits.
device-types/crypto/description.tex +11
-0+ +\begin{table}[H] +\caption{IPsec Direction} +\label{table:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Device and driver capabilities / +VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-OUTBOUND-SA / IPsec Direction} +\begin{tabularx}{\textwidth}{ |l|X|X| } \hline Type & Name & +Description \\ \hline \hline +0x0 & - & Reserved \\ +\hline +0x1 & VIRTIO_CRYPTO_IPSEC_DIR_OUTBOUND & IPsec direction outbound\\
+\hline
+0x2 &VIRTIO_CRYPTO_IPSEC_DIR_INBOUND& IPsec direction inbound \\
+\hline \end{tabularx} \end{table}
+ +\subparagraph{VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA}\label {par:Dedevice-types/crypto/description.tex +7
-1+vice Types / Crypto Device / Device Operation / IPsec Service Operation +/ Resource objects / VIRTIO-CRYPTO-RESOURCE-OBJ-IPSEC-INBOUND-SA} + +A driver can have inbound SAs between 0 and \field{inb_sa_limit}, as +specified by the capability VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the +IPsec inbound SA resource object \field{resource_obj_specific_data} is +in the format \field{struct virtio_crypto_resource_obj_ipsec_sa}. --
Quoted 1 line
2.25.1
RFC PATCH v6 3/4 virtio-crypto: Add new IPsec opcodes to data request
In reply to Srujana ChallaAdds new IPsec opcodes, VIRTIO_CRYPTO_IPSEC_OUTBOUND and VIRTIO_CRYPTO_IPSEC_INBOUND and defines opcode specific data structures for IPsec data processing.
--- device-types/crypto/description.tex | 84 +++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+)
device-types/crypto/description.tex +84 -0
@@ -379,6 +379,7 @@ \subsubsection{Operation Status}\label{sec:Device Types / Crypto Device / Device VIRTIO_CRYPTO_INVSESS = 4, VIRTIO_CRYPTO_NOSPC = 5, VIRTIO_CRYPTO_KEY_REJECTED = 6, + VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY = 7, VIRTIO_CRYPTO_MAX }; \end{lstlisting}
@@ -391,6 +392,9 @@ \subsubsection{Operation Status}\label{sec:Device Types / Crypto Device / Device \item VIRTIO_CRYPTO_NOSPC: no free session ID (only when the VIRTIO_CRYPTO_F_REVISION_1 feature bit is negotiated). \item VIRTIO_CRYPTO_KEY_REJECTED: signature verification failed (only when AKCIPHER verification). +\item VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY: IPsec SA lifetime soft limits are reached. + When VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY occurs, the request is completed successfully, + but one or all of the soft limits are reached. This is applicable only for IPsec service operations. \item VIRTIO_CRYPTO_ERR: any failure not mentioned above occurs. \end{itemize*}
@@ -992,6 +996,10 @@ \subsubsection{Data Virtqueue}\label{sec:Device Types / Crypto Device / Device O VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_AKCIPHER, 0x02) #define VIRTIO_CRYPTO_AKCIPHER_VERIFY \ VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_AKCIPHER, 0x03) +#define VIRTIO_CRYPTO_IPSEC_OUTBOUND \ + VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_IPSEC, 0x00) +#define VIRTIO_CRYPTO_IPSEC_INBOUND \ + VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_IPSEC, 0x01) le32 opcode; /* algo should be service-specific algorithms */ le32 algo;
@@ -1009,6 +1017,17 @@ \subsubsection{Data Virtqueue}\label{sec:Device Types / Crypto Device / Device O If VIRTIO_CRYPTO_F_REVISION_1 is negotiated but VIRTIO_CRYPTO_F_<SERVICE>_STATELESS_MODE is not negotiated, then the device SHOULD reject <SERVICE> requests if VIRTIO_CRYPTO_FLAG_SESSION_MODE is not set (in \field{flag}). + +For VIRTIO_CRYPTO_IPSEC_OUTBOUND and VIRTIO_CRYPTO_IPSEC_INBOUND opcodes, +\field{algo} is ignored. + +For VIRTIO_CRYPTO_IPSEC_OUTBOUND opcode, \field{session_id} MUST be set to +one of the resource objects \field{id} created using +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA resource type. + +For VIRTIO_CRYPTO_IPSEC_INBOUND opcode, \field{session_id} MUST be set to +one of the resource objects \field{id} created using +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA resource type. \end{note} The dataq request is composed of four parts:
@@ -1096,6 +1115,13 @@ \subsubsection{Data Virtqueue}\label{sec:Device Types / Crypto Device / Device O and struct virtio_crypto_akcipher_data_flf is padded to 48 bytes if NOT negotiated, and \field{op_vlf} is struct virtio_crypto_akcipher_data_vlf. \end{itemize*} +\item If the the opcode (in \field{header}) is VIRTIO_CRYPTO_IPSEC_OUTBOUND + or VIRTIO_CRYPTO_IPSEC_INBOUND then: + \begin{itemize*} + \item \field{op_flf} is struct virtio_crypto_ipsec_data_flf and + \field{op_vlf} is struct virtio_crypto_ipsec_data_vlf. + Works only for session mode. + \end{itemize*} \end{itemize*} \field{inhdr} is a unified input header that used to return the status of
@@ -1916,12 +1942,28 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / in tunnel mode, as well as the ESP/AH header on the given packet(See \hyperref[intro:IPSEC]{IPSEC} RFC). The resulting packet contains only the plain data. +The driver can request IPsec Inbound processing by +\begin{itemize*} +\item Creating inbound SAs using the VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA command. +\item Setting the \field{opcode} in struct virtio_crypto_op_data_req to +VIRTIO_CRYPTO_IPSEC_INBOUND. +\end{itemize*} + IPsec Outbound processing: The device performs encryption, attach ICV, update/add IP header and add ESP/AH header/trailer. The resulting packet contains encrypted data along with the IPsec header and trailer. +The driver can request IPsec outbound processing by +\begin{itemize*} +\item Creating outbound SAs using the VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA command. +\item Setting the \field{opcode} in struct virtio_crypto_op_data_req to +VIRTIO_CRYPTO_IPSEC_OUTBOUND. +\end{itemize*} + A crypto device can support number of IPsec SAs, allowing it to manage multiple secure connections simultaneously. +See \ref{sec:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Resource objects} +for IPsec SA information. The device and the driver indicate IPsec SA resource limits using the VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP capability specifying the limits on the number of
@@ -2191,3 +2233,45 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / capability VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the IPsec inbound SA resource object \field{resource_obj_specific_data} is in the format \field{struct virtio_crypto_resource_obj_ipsec_sa}. + +\paragraph{Data processing} +\label{par:Device Types / Crypto Device / Device Operation / IPsec Service Operation / Data processing} + +Data requests for IPsec processing are as follows: + +\begin{lstlisting} +struct virtio_crypto_ipsec_data_flf { + /* length of source data, full IP/IPsec packet */ + le32 src_data_len; + /* length of dst data */ + le32 dst_data_len; +}; + +struct virtio_crypto_ipsec_data_vlf { + /* Device read only portion */ + /* Source data */ + u8 src_data[src_data_len]; + + /* Device write only portion */ + /* Pointer to output data */ + u8 dst_data[dst_data_len]; +}; +\end{lstlisting} + +Each data request uses the virtio_crypto_ipsec_data_flf structure and +the virtio_crypto_ipsec_data_vlf structure to store information used to +run the IPSEC operations. + +For IPsec encryption: +\field{src_data} is the full IP packet that will be processed. +\field{src_data_len} is the length of source data. +\field{dst_result} is the result ESP encrypted packet and +\field{dst_data_len} is the length of it. Please note, +dst_data_len MUST include additional header and trailer +lengths. + +For IPsec decryption: +\field{src_data} is the IPsec packet that will be processed. +\field{src_data_len} is the length of source data. +\field{dst_result} is the result plain IP packet and +\field{dst_data_len} is the length of it.
Signature · 1 line
2.25.1
RE: [PATCH RFC v6 3/4] virtio-crypto: Add new IPsec opcodes to data request
Quoted 35 lines
From: Srujana Challa <[email protected]>
Sent: Thursday, April 24, 2025 3:01 PMAdds new IPsec opcodes,
VIRTIO_CRYPTO_IPSEC_OUTBOUNDandVIRTIO_CRYPTO_IPSEC_INBOUNDand defines opcode specific data structures for IPsec data processing.Reviewed-by Matias Ezequiel Vara Larsen <[email protected]>Reviewed-by Parav Pandit <[email protected]>Signed-off-by Srujana Challa <[email protected]>--- device-types/crypto/description.tex | 84 +++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+)device- renamed from device-types/crypto/description.tex +0
-0types/crypto/description.tex
index 544ac18..794b9b4 100644device-types/crypto/description.tex +0
-0@@ -379,6 +379,7 @@ \subsubsection{Operation Status}\label{sec:DeviceTypes / Crypto Device / Device
VIRTIO_CRYPTO_INVSESS= 4,
VIRTIO_CRYPTO_NOSPC= 5,
VIRTIO_CRYPTO_KEY_REJECTED= 6,device-types/crypto/description.tex +1
-0+ VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY = 7, VIRTIO_CRYPTO_MAX }; \end{lstlisting}@@ -391,6 +392,9 @@ \subsubsection{Operation Status}\label{sec:DeviceTypes / Crypto Device / Device \item
VIRTIO_CRYPTO_NOSPC: no free session ID (only when theVIRTIO_CRYPTO_F_REVISION_1
feature bit is negotiated).
\itemVIRTIO_CRYPTO_KEY_REJECTED: signature verification failed (only
when AKCIPHER verification).
Quoted 9 lines
+\item
VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY: IPsec SA lifetime soft limits are reached.
+ WhenVIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRYoccurs, the request is
completed successfully,
+ but one or all of the soft limits are reached. This is applicable only for
IPsec service operations.
\itemVIRTIO_CRYPTO_ERR: any failure not mentioned above occurs. \end{itemize*}
It would be good to have the error code for SA_HARD_EXPIRY case.VIRTIO_CRYPTO_ERR can be used , however since there is concept if SOFT_EXPIRY status code, for completeness we should have HARD_EXPIRY code.
This will be hard to do in vnet case. Yet to check.
Quoted 130 lines
device-types/crypto/description.tex +0
-0@@ -992,6 +996,10 @@ \subsubsection{Data Virtqueue}\label{sec:DeviceTypes / Crypto Device / Device O
VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_AKCIPHER, 0x02) #define VIRTIO_CRYPTO_AKCIPHER_VERIFY \ VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_AKCIPHER, 0x03)device-types/crypto/description.tex +4
-0+#define VIRTIO_CRYPTO_IPSEC_OUTBOUND \ + VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_IPSEC, 0x00) #define +VIRTIO_CRYPTO_IPSEC_INBOUND \ + VIRTIO_CRYPTO_OPCODE(VIRTIO_CRYPTO_SERVICE_IPSEC, 0x01) le32 opcode; /* algo should be service-specific algorithms */ le32 algo;@@ -1009,6 +1017,17 @@ \subsubsection{Data Virtqueue}\label{sec:DeviceTypes / Crypto Device / Device O If
VIRTIO_CRYPTO_F_REVISION_1is negotiated but VIRTIO_CRYPTO_F_<SERVICE>_STATELESS_MODE
is not negotiated, then the device SHOULD reject <SERVICE> requests ifVIRTIO_CRYPTO_FLAG_SESSION_MODEis not set (in \field{flag}).device-types/crypto/description.tex +2
-0+ +For VIRTIO_CRYPTO_IPSEC_OUTBOUND and
VIRTIO_CRYPTO_IPSEC_INBOUNDdevice-types/crypto/description.tex +3
-0+opcodes, \field{algo} is ignored. + +For VIRTIO_CRYPTO_IPSEC_OUTBOUND opcode, \field{session_id} MUST beset
device-types/crypto/description.tex +4
-0+to one of the resource objects \field{id} created using +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA resource type. + +For VIRTIO_CRYPTO_IPSEC_INBOUND opcode, \field{session_id} MUST beset
device-types/crypto/description.tex +2
-0+to one of the resource objects \field{id} created using +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA resource type. \end{note} The dataq request is composed of four parts:@@ -1096,6 +1115,13 @@ \subsubsection{Data Virtqueue}\label{sec:DeviceTypes / Crypto Device / Device O
and structvirtio_crypto_akcipher_data_flfis padded to 48 bytes if NOT
negotiated,
and \field{op_vlf} is structvirtio_crypto_akcipher_data_vlf.
\end{itemize*}
+\item If the the opcode (in \field{header}) isVIRTIO_CRYPTO_IPSEC_OUTBOUNDdevice-types/crypto/description.tex +6
-0+ or VIRTIO_CRYPTO_IPSEC_INBOUND then: + \begin{itemize*} + \item \field{op_flf} is struct virtio_crypto_ipsec_data_flf and + \field{op_vlf} is struct virtio_crypto_ipsec_data_vlf. + Works only for session mode. + \end{itemize*} \end{itemize*} \field{inhdr} is a unified input header that used to return the status of @@ -1916,12 +1942,28 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / in tunnel mode, as well as the ESP/AH header on the given
packet(See \hyperref[intro:IPSEC]{IPSEC} RFC).
The resulting packet contains only the plain data.+The driver can request IPsec Inbound processing by \begin{itemize*} +\item Creating inbound SAs using the
VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SAcommand.
+\item Setting the \field{opcode} in structvirtio_crypto_op_data_reqtodevice-types/crypto/description.tex +3
-0+VIRTIO_CRYPTO_IPSEC_INBOUND. +\end{itemize*} + IPsec Outbound processing: The device performs encryption, attach ICV,update/add IP header and add ESP/AH header/trailer. The resulting packet contains encrypted data along with the IPsec header and trailer.
+The driver can request IPsec outbound processing by \begin{itemize*} +\item Creating outbound SAs using the
VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SAcommand.
+\item Setting the \field{opcode} in structvirtio_crypto_op_data_reqtodevice-types/crypto/description.tex +3
-0+VIRTIO_CRYPTO_IPSEC_OUTBOUND. +\end{itemize*} + A crypto device can support number of IPsec SAs, allowing it to managemultiple secure connections simultaneously.
device-types/crypto/description.tex +2
-0+See \ref{sec:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Resource objects} for IPsec SA information. The device and the driver indicate IPsec SA resource limits using the
VIRTIO_CRYPTO_IPSEC_RESOURCE_CAPcapability specifying the limits on the number of @@ -2191,3 +2233,45 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / capabilityVIRTIO_CRYPTO_IPSEC_RESOURCE_CAP. For the IPsec inbound SA resource object \field{resource_obj_specific_data} is in the format \field{structvirtio_crypto_resource_obj_ipsec_sa}.device-types/crypto/description.tex +42
-1+ +\paragraph{Data processing} +\label{par:Device Types / Crypto Device / Device Operation / IPsec +Service Operation / Data processing} + +Data requests for IPsec processing are as follows: + +\begin{lstlisting} +struct virtio_crypto_ipsec_data_flf { + /* length of source data, full IP/IPsec packet */ + le32 src_data_len; + /* length of dst data */ + le32 dst_data_len; +}; + +struct virtio_crypto_ipsec_data_vlf { + /* Device read only portion */ + /* Source data */ + u8 src_data[src_data_len]; + + /* Device write only portion */ + /* Pointer to output data */ + u8 dst_data[dst_data_len]; +}; +\end{lstlisting} + +Each data request uses the virtio_crypto_ipsec_data_flf structure and +the virtio_crypto_ipsec_data_vlf structure to store information used to +run the IPSEC operations. + +For IPsec encryption: +\field{src_data} is the full IP packet that will be processed. +\field{src_data_len} is the length of source data. +\field{dst_result} is the result ESP encrypted packet and +\field{dst_data_len} is the length of it. Please note, dst_data_len +MUST include additional header and trailer lengths. + +For IPsec decryption: +\field{src_data} is the IPsec packet that will be processed. +\field{src_data_len} is the length of source data. +\field{dst_result} is the result plain IP packet and +\field{dst_data_len} is the length of it. --
Quoted 1 line
2.25.1
Apart from above comment,
RFC PATCH v6 4/4 virtio-crypto: Add device and driver requirements for IPsec operation
In reply to Srujana ChallaAdd device and driver requirements for IPsec Operation.
--- device-types/crypto/description.tex | 97 ++++++++++++++++++++++ device-types/crypto/device-conformance.tex | 1 + device-types/crypto/driver-conformance.tex | 1 + 3 files changed, 99 insertions(+)
device-types/crypto/description.tex +97 -0
@@ -2275,3 +2275,100 @@ \subsubsection{IPSEC Service Operation}\label{sec:Device Types / Crypto Device / \field{src_data_len} is the length of source data. \field{dst_result} is the result plain IP packet and \field{dst_data_len} is the length of it. + +\devicenormative{\paragraph}{IPsec Service Operation}{Device Types / Crypto Device / Device Operation / IPsec Service Operation} + +When the device supports IPsec operations, +\begin{itemize} +\item the device MUST set VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP, VIRTIO_CRYPTO_IPSEC_SA_CAP +capability in the \field{supported_caps} in the command VIRTIO_ADMIN_CMD_CAP_SUPPORT_QUERY. +\item the device MUST support the administration commands +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE, +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_MODIFY, VIRTIO_ADMIN_CMD_RESOURCE_OBJ_QUERY, +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_DESTROY for the resource types +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA and VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA. +\end{itemize} + +When any of the VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP or VIRTIO_CRYPTO_IPSEC_SA_CAP +capability is disabled, the device MUST set \field{status} to +VIRTIO_ADMIN_STATUS_Q_INVALID_OPCODE for the commands +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE, +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_MODIFY, VIRTIO_ADMIN_CMD_RESOURCE_OBJ_QUERY, +and VIRTIO_ADMIN_CMD_RESOURCE_OBJ_DESTROY for the resource types +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA and VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA. + +The device MUST set \field{status} to VIRTIO_ADMIN_STATUS_EEXIST for the +command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE when the resource \field{type} +is VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA or VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA, +if the object already exists with the supplied \field{id}. + +The device MUST fail the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE with +the \field{status} set to VIRTIO_ADMIN_STATUS_EINVAL, for the +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA object if, +\begin{itemize} +\item \field{id} is greater than or equal to \field{outb_sa_limit}. +\item the supplied SA parameters, such as mode, options, cipher and authentication + algorithms are not supported in the capabitlity VIRTIO_CRYPTO_IPSEC_SA_CAP. +\end{itemize} + +The device MUST fail the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE with +the \field{status} set to VIRTIO_ADMIN_STATUS_EINVAL, for the +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA object if, +\begin{itemize} +\item \field{id} is greater than or equal to \field{inb_sa_limit}. +\item the supplied SA parameters, such as mode, options, cipher and authentication + algorithms are not supported in the capabitlity VIRTIO_CRYPTO_IPSEC_SA_CAP. +\end{itemize} + +The device SHOULD maintain a table for subsequent lookups for inbound/outbound data +processing with the corresponding SA based on the supplied \field{id}. + +The device MUST allow recreating the resource objects using the command +VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE which was previously destroyed using +the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_DESTROY respectively without +undergoing a device reset. + +The device MAY fail the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE with +the \field{status} set to VIRTIO_ADMIN_STATUS_EINVAL for the +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA or VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA +commands if the resource object with the same \field{spi} already exists. + +On device reset, the device MUST destroy all the resource objects which have been created. + +The device MUST copy the result of IPsec operation in the \field{dst_data[]}. +The device MUST set the \field{status} field in struct virtio_crypto_inhdr to +one of the following values of enum VIRTIO_CRYPTO_STATUS: +\begin{itemize*} +\item VIRTIO_CRYPTO_OK if the operation success. +\item VIRTIO_CRYPTO_NOTSUPP if the requested algorithm or operation is unsupported. +\item VIRTIO_CRYPTO_BADMSG if the integrity check is failed for IPsec decryption. +\item VIRTIO_CRYPTO_INVSESS if the session ID invalid. +\item VIRTIO_CRYPTO_ERR if any failure not mentioned above occurs. +\item VIRTIO_CRYPTO_IPSEC_SA_SOFT_EXPIRY if an IPsec SA reaches the SA soft expiry limit +configured in \field{struct virtio_crypto_ipsec_lifetime}. +\end{itemize*} + +\drivernormative{\paragraph}{IPsec Service Operation}{Device Types / Crypto Device / Device Operation / IPsec Service Operation} + +The driver MUST query the capabilities using VIRTIO_ADMIN_CMD_CAP_ID_LIST_QUERY +to discover the capability types the device offers. + +The driver MUST get VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP and VIRTIO_CRYPTO_IPSEC_SA_CAP +if listed in VIRTIO_ADMIN_CMD_CAP_ID_LIST_QUERY command result, using +VIRTION_ADMIN_CMD_DEVICE_CAP_GET to discover the capabilities the device is +able to offer. +The driver MUST set VIRTIO_CRYPTO_IPSEC_RESOURCE_CAP and VIRTIO_CRYPTO_IPSEC_SA_CAP +using VIRTIO_ADMIN_CMD_DEVICE_CAP_SET to indicate the device which capability +the driver uses. + +For the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE, when creating a resource +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA, the driver MUST set all the parameters +in \field{struct virtio_crypto_resource_obj_ipsec_sa} with relevant values. +And when create a resource object VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA, +the driver MUST set all the parameters except \field{struct virtio_crypto_ipsec_tunnel_param}. + +The driver MUST set \field{session_id} in struct virtio_crypto_op_header to a +valid VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_OUTBOUND_SA or +VIRTIO_CRYPTO_RESOURCE_OBJ_IPSEC_INBOUND_SA \field{id}. +The driver MUST set the \field{opcode} field in struct virtio_crypto_op_header +to one of VIRTIO_CRYPTO_IPSEC_OUTBOUND and VIRTIO_CRYPTO_IPSEC_INBOUND.
device-types/crypto/device-conformance.tex +1 -0
@@ -10,4 +10,5 @@ \item \ref{devicenormative:Device Types / Crypto Device / Device Operation / MAC Service Operation} \item \ref{devicenormative:Device Types / Crypto Device / Device Operation / Symmetric algorithms Operation} \item \ref{devicenormative:Device Types / Crypto Device / Device Operation / AEAD Service Operation} +\item \ref{devicenormative:Device Types / Crypto Device / Device Operation / IPsec Service Operation} \end{itemize}
device-types/crypto/driver-conformance.tex +1 -0
@@ -11,4 +11,5 @@ \item \ref{drivernormative:Device Types / Crypto Device / Device Operation / MAC Service Operation} \item \ref{drivernormative:Device Types / Crypto Device / Device Operation / Symmetric algorithms Operation} \item \ref{drivernormative:Device Types / Crypto Device / Device Operation / AEAD Service Operation} +\item \ref{drivernormative:Device Types / Crypto Device / Device Operation / IPsec Service Operation} \end{itemize}
Signature · 1 line
2.25.1
Quoted 8 lines · Srujana Challa
This series enhances virtio-crypto by adding support for IPsec services. These patches aim to extend the capabilities of virtio-crypto, enabling it to handle IPsec operations efficiently. In addition to standard crypto processing, the IPsec protocol processing is also offloaded to the Crypto device as lookaside operation.
It utilizes new virtio basic facilities, including capability and resource objects. Below is a summary of the changes introduced:
please do submit a non RFC version before you ask for a vote. can you explain in a bit more detail how you envision this interacting with the virtio-net patches you also proposed?
Quoted 50 lines
Patch1:
This patch introduces the foundational support for IPsec services within the virtio-crypto framework, outlining the necessary capabilities for IPsec operations.Patch2:
This patch adds resource objects required for programming IPsec Security Associations (SAs) for both encryption and decryption processes.Patch3:
This patch includes new opcodes specific to IPsec operations, facilitating the handling of IPsec data requests within the virtio-crypto driver.Patch4:
This patch specifies the requirements for both the device and the driver to support IPsec operations.These enhancements are for providing support for IPsec within the virtio-crypto device/driver, improving security and performance for virtualized environments. We believe these additions will significantly benefit users who rely on virtio-crypto for secure data transmission.
v2:
- Addressed the review comments from Matias.
v3:
- Addressed the review comments from Parav Pandit.
v4:
- IntroducedCOPY_DF, ECN and SA LIFETIME to the SA options.
- Introduced SA lifetime to the SA resource object data structure.
- Set cipher and auth key arrays to fixed sizes.
v5:
- Addressed minor review comments from Parav Pandit.
v6:
- The esn field has been removed from the IPsec SA resource object.Srujana Challa (4):
virtio-crypto: Add IPsec service operation and Capabilities
virtio-crypto: Add resource objects for IPsec outbound and inbound SAs
virtio-crypto: Add new IPsec opcodes to data request
virtio-crypto: Add device and driver requirements for IPsec operationdevice-types/crypto/description.tex | 510 ++++++++++++++++++++- device-types/crypto/device-conformance.tex | 1 + device-types/crypto/driver-conformance.tex | 1 + introduction.tex | 12 + 4 files changed, 519 insertions(+), 5 deletions(-)Signature · 1 line
2.25.1
Quoted 11 lines · Srujana Challa
Quoted 8 lines
This series enhances virtio-crypto by adding support for IPsec services. These patches aim to extend the capabilities of virtio-crypto, enabling it to handle IPsec operations efficiently. In addition to standard crypto processing, the IPsec protocol processing is also offloaded to the Crypto device as lookaside operation.
It utilizes new virtio basic facilities, including capability and resource objects. Below is a summary of the changes introduced:
please do submit a non RFC version before you ask for a vote.
Sure, will do.
Quoted 2 lines
can you explain in a bit more detail how you envision this interacting with the virtio-net patches you also proposed?
There isn't a direct interaction between the virtio-net and virtio-crypto devices.
Instead, virtio-net leverages certain definitions and structures from virtio-crypto
to avoid redundancy. Here is a detailed breakdown,
1. Reuse of Resource Objects and capabilities Data Structures
Virtio-Net: Utilizes the resource object and capability data structures defined in the virtio-crypto patches.
Virtio-Crypto: Defines these resource objects and capabilities to support IPsec operations within its framework.
2. Crypto Algorithm Definition Macros
Virtio-Net: Reuses the cryptographic algorithm definition macros from virtio-crypto. This reuse helps maintain consistency in how cryptographic algorithms are defined and used across both frameworks.
Virtio-Crypto: Provides these macros to standardize the definition of cryptographic algorithms.
3. Command Type Values
Capability Command Type: The command type values for capabilities are different between virtio-net and virtio-crypto. This distinction ensures that each framework can manage its capabilities independently without conflicts. Resource Object Command Type: Similarly, the command type values for resource objects are unique to each framework, allowing virtio-net and virtio-crypto to handle their respective resource objects separately.
Quoted 20 lines
Quoted 20 lines
Patch1:
This patch introduces the foundational support for IPsec services within the virtio-crypto framework, outlining the necessary capabilities for IPsec operations.Patch2:
This patch adds resource objects required for programming IPsec Security Associations (SAs) for both encryption and decryption processes.Patch3:
This patch includes new opcodes specific to IPsec operations, facilitating the handling of IPsec data requests within the virtio-crypto driver.Patch4:
This patch specifies the requirements for both the device and the driver to support IPsec operations.
Quoted 34 lines
Quoted 4 lines
These enhancements are for providing support for IPsec within the virtio-crypto device/driver, improving security and performance for virtualized environments. We believe these additions will significantly benefit users who rely on virtio-crypto for secure data
transmission.
Quoted 29 lines
v2:
- Addressed the review comments from Matias.
v3:
- Addressed the review comments from Parav Pandit.
v4:
- IntroducedCOPY_DF, ECN and SA LIFETIME to the SA options.
- Introduced SA lifetime to the SA resource object data structure.
- Set cipher and auth key arrays to fixed sizes.
v5:
- Addressed minor review comments from Parav Pandit.
v6:
- The esn field has been removed from the IPsec SA resource object.Srujana Challa (4):
virtio-crypto: Add IPsec service operation and Capabilities
virtio-crypto: Add resource objects for IPsec outbound and inbound SAs
virtio-crypto: Add new IPsec opcodes to data request
virtio-crypto: Add device and driver requirements for IPsec
operationdevice-types/crypto/description.tex | 510 ++++++++++++++++++++- device-types/crypto/device-conformance.tex | 1 + device-types/crypto/driver-conformance.tex | 1 + introduction.tex | 12 + 4 files changed, 519 insertions(+), 5 deletions(-)--
2.25.1
Thanks.