xref: /openbmc/phosphor-net-ipmid/command/rakp34.cpp (revision ae1fda44032a361874417c4006ddcbd951974399)
150fb50a9STom Joseph #include "rakp34.hpp"
250fb50a9STom Joseph 
350fb50a9STom Joseph #include "comm_module.hpp"
450fb50a9STom Joseph #include "endian.hpp"
550fb50a9STom Joseph #include "guid.hpp"
650fb50a9STom Joseph #include "main.hpp"
79b307be6SVernon Mauery #include "rmcp.hpp"
850fb50a9STom Joseph 
99e801a2bSVernon Mauery #include <algorithm>
109e801a2bSVernon Mauery #include <cstring>
119e801a2bSVernon Mauery #include <iostream>
129e801a2bSVernon Mauery 
1350fb50a9STom Joseph namespace command
1450fb50a9STom Joseph {
1550fb50a9STom Joseph 
16ef02fb3dSTom Joseph void applyIntegrityAlgo(const uint32_t bmcSessionID)
17ef02fb3dSTom Joseph {
189e801a2bSVernon Mauery     auto session =
19*ae1fda44SVernon Mauery         std::get<session::Manager&>(singletonPool).getSession(bmcSessionID);
20ef02fb3dSTom Joseph 
21ef02fb3dSTom Joseph     auto authAlgo = session->getAuthAlgo();
22ef02fb3dSTom Joseph 
23ef02fb3dSTom Joseph     switch (authAlgo->intAlgo)
24ef02fb3dSTom Joseph     {
25ef02fb3dSTom Joseph         case cipher::integrity::Algorithms::HMAC_SHA1_96:
26ef02fb3dSTom Joseph         {
27ef02fb3dSTom Joseph             session->setIntegrityAlgo(
28ef02fb3dSTom Joseph                 std::make_unique<cipher::integrity::AlgoSHA1>(
29ef02fb3dSTom Joseph                     authAlgo->sessionIntegrityKey));
30ef02fb3dSTom Joseph             break;
31ef02fb3dSTom Joseph         }
327e9e2ef6SVernon Mauery         case cipher::integrity::Algorithms::HMAC_SHA256_128:
337e9e2ef6SVernon Mauery         {
347e9e2ef6SVernon Mauery             session->setIntegrityAlgo(
357e9e2ef6SVernon Mauery                 std::make_unique<cipher::integrity::AlgoSHA256>(
367e9e2ef6SVernon Mauery                     authAlgo->sessionIntegrityKey));
377e9e2ef6SVernon Mauery             break;
387e9e2ef6SVernon Mauery         }
39ef02fb3dSTom Joseph         default:
40ef02fb3dSTom Joseph             break;
41ef02fb3dSTom Joseph     }
42ef02fb3dSTom Joseph }
43ef02fb3dSTom Joseph 
444c766eb1STom Joseph void applyCryptAlgo(const uint32_t bmcSessionID)
454c766eb1STom Joseph {
469e801a2bSVernon Mauery     auto session =
47*ae1fda44SVernon Mauery         std::get<session::Manager&>(singletonPool).getSession(bmcSessionID);
484c766eb1STom Joseph 
494c766eb1STom Joseph     auto authAlgo = session->getAuthAlgo();
504c766eb1STom Joseph 
514c766eb1STom Joseph     switch (authAlgo->cryptAlgo)
524c766eb1STom Joseph     {
534c766eb1STom Joseph         case cipher::crypt::Algorithms::AES_CBC_128:
544c766eb1STom Joseph         {
559b307be6SVernon Mauery             auto intAlgo = session->getIntegrityAlgo();
569e801a2bSVernon Mauery             auto k2 = intAlgo->generateKn(authAlgo->sessionIntegrityKey,
579e801a2bSVernon Mauery                                           rmcp::const_2);
589b307be6SVernon Mauery             session->setCryptAlgo(
599b307be6SVernon Mauery                 std::make_unique<cipher::crypt::AlgoAES128>(k2));
604c766eb1STom Joseph             break;
614c766eb1STom Joseph         }
624c766eb1STom Joseph         default:
634c766eb1STom Joseph             break;
644c766eb1STom Joseph     }
654c766eb1STom Joseph }
664c766eb1STom Joseph 
6718a45e9dSTom Joseph std::vector<uint8_t> RAKP34(const std::vector<uint8_t>& inPayload,
6850fb50a9STom Joseph                             const message::Handler& handler)
6950fb50a9STom Joseph {
7050fb50a9STom Joseph 
7150fb50a9STom Joseph     std::vector<uint8_t> outPayload(sizeof(RAKP4response));
7218a45e9dSTom Joseph     auto request = reinterpret_cast<const RAKP3request*>(inPayload.data());
7350fb50a9STom Joseph     auto response = reinterpret_cast<RAKP4response*>(outPayload.data());
7450fb50a9STom Joseph 
7550fb50a9STom Joseph     // Check if the RAKP3 Payload Length is as expected
769b307be6SVernon Mauery     if (inPayload.size() < sizeof(RAKP3request))
7750fb50a9STom Joseph     {
7850fb50a9STom Joseph         std::cerr << "RAKP34: Invalid RAKP3 request\n";
7950fb50a9STom Joseph         response->rmcpStatusCode =
8050fb50a9STom Joseph             static_cast<uint8_t>(RAKP_ReturnCode::INVALID_INTEGRITY_VALUE);
8150fb50a9STom Joseph         return outPayload;
8250fb50a9STom Joseph     }
8350fb50a9STom Joseph 
8450fb50a9STom Joseph     // Session ID zero is reserved for Session Setup
8550fb50a9STom Joseph     if (endian::from_ipmi(request->managedSystemSessionID) ==
8650fb50a9STom Joseph         session::SESSION_ZERO)
8750fb50a9STom Joseph     {
8850fb50a9STom Joseph         std::cerr << "RAKP34: BMC invalid Session ID\n";
8950fb50a9STom Joseph         response->rmcpStatusCode =
9050fb50a9STom Joseph             static_cast<uint8_t>(RAKP_ReturnCode::INVALID_SESSION_ID);
9150fb50a9STom Joseph         return outPayload;
9250fb50a9STom Joseph     }
9350fb50a9STom Joseph 
9450fb50a9STom Joseph     std::shared_ptr<session::Session> session;
9550fb50a9STom Joseph     try
9650fb50a9STom Joseph     {
97*ae1fda44SVernon Mauery         session =
98*ae1fda44SVernon Mauery             std::get<session::Manager&>(singletonPool)
99*ae1fda44SVernon Mauery                 .getSession(endian::from_ipmi(request->managedSystemSessionID));
10050fb50a9STom Joseph     }
10150fb50a9STom Joseph     catch (std::exception& e)
10250fb50a9STom Joseph     {
10350fb50a9STom Joseph         std::cerr << e.what() << "\n";
10450fb50a9STom Joseph         response->rmcpStatusCode =
10550fb50a9STom Joseph             static_cast<uint8_t>(RAKP_ReturnCode::INVALID_SESSION_ID);
10650fb50a9STom Joseph         return outPayload;
10750fb50a9STom Joseph     }
10850fb50a9STom Joseph 
10950fb50a9STom Joseph     session->updateLastTransactionTime();
11050fb50a9STom Joseph 
11150fb50a9STom Joseph     auto authAlgo = session->getAuthAlgo();
11250fb50a9STom Joseph     /*
11350fb50a9STom Joseph      * Key Authentication Code - RAKP 3
11450fb50a9STom Joseph      *
11550fb50a9STom Joseph      * 1) Managed System Random Number - 16 bytes
11650fb50a9STom Joseph      * 2) Remote Console Session ID - 4 bytes
11750fb50a9STom Joseph      * 3) Session Privilege Level - 1 byte
11850fb50a9STom Joseph      * 4) User Name Length Byte - 1 byte (0 for 'null' username)
11950fb50a9STom Joseph      * 5) User Name - variable (absent for 'null' username)
12050fb50a9STom Joseph      */
12150fb50a9STom Joseph 
12250fb50a9STom Joseph     // Remote Console Session ID
12350fb50a9STom Joseph     auto rcSessionID = endian::to_ipmi(session->getRCSessionID());
12450fb50a9STom Joseph 
12550fb50a9STom Joseph     // Session Privilege Level
12650fb50a9STom Joseph     auto sessPrivLevel = static_cast<uint8_t>(session->curPrivLevel);
12750fb50a9STom Joseph 
12850fb50a9STom Joseph     // User Name Length Byte
12956527b93STom Joseph     auto userLength = static_cast<uint8_t>(session->userName.size());
13050fb50a9STom Joseph 
13150fb50a9STom Joseph     std::vector<uint8_t> input;
13250fb50a9STom Joseph     input.resize(cipher::rakp_auth::BMC_RANDOM_NUMBER_LEN +
13350fb50a9STom Joseph                  sizeof(rcSessionID) + sizeof(sessPrivLevel) +
13456527b93STom Joseph                  sizeof(userLength) + userLength);
13550fb50a9STom Joseph 
13650fb50a9STom Joseph     auto iter = input.begin();
13750fb50a9STom Joseph 
13850fb50a9STom Joseph     // Managed System Random Number
13950fb50a9STom Joseph     std::copy(authAlgo->bmcRandomNum.begin(), authAlgo->bmcRandomNum.end(),
14050fb50a9STom Joseph               iter);
14150fb50a9STom Joseph     std::advance(iter, cipher::rakp_auth::BMC_RANDOM_NUMBER_LEN);
14250fb50a9STom Joseph 
14350fb50a9STom Joseph     // Remote Console Session ID
14450fb50a9STom Joseph     std::copy_n(reinterpret_cast<uint8_t*>(&rcSessionID), sizeof(rcSessionID),
14550fb50a9STom Joseph                 iter);
14650fb50a9STom Joseph     std::advance(iter, sizeof(rcSessionID));
14750fb50a9STom Joseph 
14850fb50a9STom Joseph     // Session Privilege Level
14950fb50a9STom Joseph     std::copy_n(reinterpret_cast<uint8_t*>(&sessPrivLevel),
15050fb50a9STom Joseph                 sizeof(sessPrivLevel), iter);
15150fb50a9STom Joseph     std::advance(iter, sizeof(sessPrivLevel));
15250fb50a9STom Joseph 
15350fb50a9STom Joseph     // User Name Length Byte
15450fb50a9STom Joseph     std::copy_n(&userLength, sizeof(userLength), iter);
15556527b93STom Joseph     std::advance(iter, sizeof(userLength));
15656527b93STom Joseph 
15756527b93STom Joseph     std::copy_n(session->userName.data(), userLength, iter);
15850fb50a9STom Joseph 
15950fb50a9STom Joseph     // Generate Key Exchange Authentication Code - RAKP2
16050fb50a9STom Joseph     auto output = authAlgo->generateHMAC(input);
16150fb50a9STom Joseph 
1629b307be6SVernon Mauery     if (inPayload.size() != (sizeof(RAKP3request) + output.size()) ||
1639b307be6SVernon Mauery         std::memcmp(output.data(), request + 1, output.size()))
16450fb50a9STom Joseph     {
16550fb50a9STom Joseph         std::cerr << "Mismatch in HMAC sent by remote console\n";
16650fb50a9STom Joseph 
16750fb50a9STom Joseph         response->messageTag = request->messageTag;
1689e801a2bSVernon Mauery         response->rmcpStatusCode =
1699e801a2bSVernon Mauery             static_cast<uint8_t>(RAKP_ReturnCode::INVALID_INTEGRITY_VALUE);
17050fb50a9STom Joseph         response->reserved = 0;
17150fb50a9STom Joseph         response->remoteConsoleSessionID = rcSessionID;
17250fb50a9STom Joseph 
17350fb50a9STom Joseph         // close the session
1749e801a2bSVernon Mauery         std::get<session::Manager&>(singletonPool)
1759e801a2bSVernon Mauery             .stopSession(session->getBMCSessionID());
17650fb50a9STom Joseph 
17750fb50a9STom Joseph         return outPayload;
17850fb50a9STom Joseph     }
17950fb50a9STom Joseph 
18050fb50a9STom Joseph     /*
18150fb50a9STom Joseph      * Session Integrity Key
18250fb50a9STom Joseph      *
18350fb50a9STom Joseph      * 1) Remote Console Random Number - 16 bytes
18450fb50a9STom Joseph      * 2) Managed System Random Number - 16 bytes
18550fb50a9STom Joseph      * 3) Session Privilege Level - 1 byte
18650fb50a9STom Joseph      * 4) User Name Length Byte - 1 byte (0 for 'null' username)
18750fb50a9STom Joseph      * 5) User Name - variable (absent for 'null' username)
18850fb50a9STom Joseph      */
18950fb50a9STom Joseph 
19050fb50a9STom Joseph     input.clear();
19150fb50a9STom Joseph 
19250fb50a9STom Joseph     input.resize(cipher::rakp_auth::REMOTE_CONSOLE_RANDOM_NUMBER_LEN +
19350fb50a9STom Joseph                  cipher::rakp_auth::BMC_RANDOM_NUMBER_LEN +
19456527b93STom Joseph                  sizeof(sessPrivLevel) + sizeof(userLength) + userLength);
19550fb50a9STom Joseph     iter = input.begin();
19650fb50a9STom Joseph 
19750fb50a9STom Joseph     // Remote Console Random Number
1989e801a2bSVernon Mauery     std::copy(authAlgo->rcRandomNum.begin(), authAlgo->rcRandomNum.end(), iter);
19950fb50a9STom Joseph     std::advance(iter, cipher::rakp_auth::REMOTE_CONSOLE_RANDOM_NUMBER_LEN);
20050fb50a9STom Joseph 
20150fb50a9STom Joseph     // Managed Console Random Number
20250fb50a9STom Joseph     std::copy(authAlgo->bmcRandomNum.begin(), authAlgo->bmcRandomNum.end(),
20350fb50a9STom Joseph               iter);
20450fb50a9STom Joseph     std::advance(iter, cipher::rakp_auth::BMC_RANDOM_NUMBER_LEN);
20550fb50a9STom Joseph 
20650fb50a9STom Joseph     // Session Privilege Level
20750fb50a9STom Joseph     std::copy_n(reinterpret_cast<uint8_t*>(&sessPrivLevel),
20850fb50a9STom Joseph                 sizeof(sessPrivLevel), iter);
20950fb50a9STom Joseph     std::advance(iter, sizeof(sessPrivLevel));
21050fb50a9STom Joseph 
21150fb50a9STom Joseph     // User Name Length Byte
21250fb50a9STom Joseph     std::copy_n(&userLength, sizeof(userLength), iter);
21356527b93STom Joseph     std::advance(iter, sizeof(userLength));
21456527b93STom Joseph 
21556527b93STom Joseph     std::copy_n(session->userName.data(), userLength, iter);
21650fb50a9STom Joseph 
21750fb50a9STom Joseph     // Generate Session Integrity Key
21850fb50a9STom Joseph     auto sikOutput = authAlgo->generateHMAC(input);
21950fb50a9STom Joseph 
22050fb50a9STom Joseph     // Update the SIK in the Authentication Algo Interface
22150fb50a9STom Joseph     authAlgo->sessionIntegrityKey.insert(authAlgo->sessionIntegrityKey.begin(),
22250fb50a9STom Joseph                                          sikOutput.begin(), sikOutput.end());
22350fb50a9STom Joseph 
22450fb50a9STom Joseph     /*
22550fb50a9STom Joseph      * Integrity Check Value
22650fb50a9STom Joseph      *
22750fb50a9STom Joseph      * 1) Remote Console Random Number - 16 bytes
22850fb50a9STom Joseph      * 2) Managed System Session ID - 4 bytes
22950fb50a9STom Joseph      * 3) Managed System GUID - 16 bytes
23050fb50a9STom Joseph      */
23150fb50a9STom Joseph 
23250fb50a9STom Joseph     // Get Managed System Session ID
23350fb50a9STom Joseph     auto bmcSessionID = endian::to_ipmi(session->getBMCSessionID());
23450fb50a9STom Joseph 
23550fb50a9STom Joseph     input.clear();
23650fb50a9STom Joseph 
23750fb50a9STom Joseph     input.resize(cipher::rakp_auth::REMOTE_CONSOLE_RANDOM_NUMBER_LEN +
23850fb50a9STom Joseph                  sizeof(bmcSessionID) + BMC_GUID_LEN);
23950fb50a9STom Joseph     iter = input.begin();
24050fb50a9STom Joseph 
24150fb50a9STom Joseph     // Remote Console Random Number
2429e801a2bSVernon Mauery     std::copy(authAlgo->rcRandomNum.begin(), authAlgo->rcRandomNum.end(), iter);
24350fb50a9STom Joseph     std::advance(iter, cipher::rakp_auth::REMOTE_CONSOLE_RANDOM_NUMBER_LEN);
24450fb50a9STom Joseph 
24550fb50a9STom Joseph     // Managed System Session ID
24650fb50a9STom Joseph     std::copy_n(reinterpret_cast<uint8_t*>(&bmcSessionID), sizeof(bmcSessionID),
24750fb50a9STom Joseph                 iter);
24850fb50a9STom Joseph     std::advance(iter, sizeof(bmcSessionID));
24950fb50a9STom Joseph 
25050fb50a9STom Joseph     // Managed System GUID
25183029cb8STom Joseph     std::copy_n(cache::guid.data(), cache::guid.size(), iter);
25250fb50a9STom Joseph 
25350fb50a9STom Joseph     // Integrity Check Value
25450fb50a9STom Joseph     auto icv = authAlgo->generateICV(input);
25550fb50a9STom Joseph 
25650fb50a9STom Joseph     outPayload.resize(sizeof(RAKP4response));
25750fb50a9STom Joseph 
25850fb50a9STom Joseph     response->messageTag = request->messageTag;
25950fb50a9STom Joseph     response->rmcpStatusCode = static_cast<uint8_t>(RAKP_ReturnCode::NO_ERROR);
26050fb50a9STom Joseph     response->reserved = 0;
26150fb50a9STom Joseph     response->remoteConsoleSessionID = rcSessionID;
26250fb50a9STom Joseph 
26350fb50a9STom Joseph     // Insert the HMAC output into the payload
26450fb50a9STom Joseph     outPayload.insert(outPayload.end(), icv.begin(), icv.end());
26550fb50a9STom Joseph 
266ef02fb3dSTom Joseph     // Set the Integrity Algorithm
267ef02fb3dSTom Joseph     applyIntegrityAlgo(session->getBMCSessionID());
268818d0701STom Joseph 
2694c766eb1STom Joseph     // Set the Confidentiality Algorithm
2704c766eb1STom Joseph     applyCryptAlgo(session->getBMCSessionID());
2714c766eb1STom Joseph 
27250fb50a9STom Joseph     session->state = session::State::ACTIVE;
27350fb50a9STom Joseph     return outPayload;
27450fb50a9STom Joseph }
27550fb50a9STom Joseph 
27650fb50a9STom Joseph } // namespace command
277