SDK de Microsoft Information Protection: implementación de un delegado de autenticación (C++)

El SDK de MIP implementa un delegado de autenticación para controlar los desafíos de autenticación y responder con un token. No implementa la adquisición de tokens. El proceso de adquisición de tokens depende del desarrollador y se logra mediante la extensión de la clase mip::AuthDelegate, específicamente de la función miembro AcquireOAuth2Token.

Compilación de AuthDelegateImpl

Para ampliar la clase mip::AuthDelegatebase , creamos una nueva clase denominada sample::auth::AuthDelegateImpl. Esta clase implementa la AcquireOAuth2Token funcionalidad y configura el constructor para que tome nuestros parámetros de autenticación.

auth_delegate_impl.h

En este ejemplo, el constructor predeterminado acepta solo el nombre de usuario, la contraseña y el identificador de aplicación de la aplicación. Estos se almacenarán en las variables mUserNameprivadas , mPasswordy mClientId.

Es importante tener en cuenta que no es necesario implementar información como el proveedor de identidades o el URI de recursos, al menos no en el AuthDelegateImpl constructor. Esa información se pasa como parte de AcquireOAuth2Token en el objeto OAuth2Challenge. En su lugar, pasaremos esos detalles a la llamada AcquireToken en AcquireOAuth2Token.

//auth_delegate_impl.h
#include <string.h>
#include "mip/common_types.h"

namespace sample {
namespace auth {
class AuthDelegateImpl final : public mip::AuthDelegate { //extend mip::AuthDelegate base class
public:
  AuthDelegateImpl() = delete;

//constructor accepts username, password, and mip::ApplicationInfo.
  AuthDelegateImpl::AuthDelegateImpl(
    const mip::ApplicationInfo& applicationInfo,
    std::string& username,
    const std::string& password)
    : mApplicationInfo(applicationInfo),
      mUserName(username),
      mPassword(password) {
  }

  bool AcquireOAuth2Token(const mip::Identity& identity, const OAuth2Challenge& challenge, OAuth2Token& token) override;

  private:
    std::string mUserName;
    std::string mPassword;
    std::string mClientId;
    mip::ApplicationInfo mApplicationInfo;
};
}
}

auth_delegate_impl.cpp

AcquireOAuth2Token es donde se realizará la llamada al proveedor OAuth2. En el ejemplo siguiente hay dos llamadas a AcquireToken(). En la práctica, solo se realizaría una llamada. Estas implementaciones se tratarán en las secciones proporcionadas en Pasos siguientes.

//auth_delegate_impl.cpp
#include "auth_delegate_impl.h"
#include <stdexcept>
#include "auth.h" //contains the auth class used later for token acquisition

using std::runtime_error;
using std::string;

namespace sample {
namespace auth {

AuthDelegateImpl::AuthDelegateImpl(
    const string& userName,
    const string& password,
    const string& clientId)
    : mApplicationInfo(applicationInfo),
    mUserName(userName),
    mPassword(password) {
}

//Here we could simply add our token acquisition code to AcquireOAuth2Token
//Instead, that code is implemented in auth.h/cpp to demonstrate calling an external library
bool AuthDelegateImpl::AcquireOAuth2Token(
    const mip::Identity& /*identity*/, //This won't be used
    const OAuth2Challenge& challenge,
    const OAuth2Token& token) {

      //sample::auth::AcquireToken is the code where the token acquisition routine is implemented.
      //AcquireToken() returns a string that contains the OAuth2 token.

      //Simple example for getting hard coded token. Comment out if not used.
      string accessToken = sample::auth::AcquireToken();

      //Practical example for calling external OAuth2 library with provided authentication details.
      string accessToken = sample::auth::AcquireToken(mUserName, mPassword, mApplicationInfo.applicationId, challenge.GetAuthority(), challenge.GetResource());

      //set the passed in OAuth2Token value to the access token acquired by our provider
      token.SetAccessToken(accessToken);
      return true;
    }
}
}

Pasos siguientes

Para completar la implementación de autenticación, es necesario compilar el código subyacente a la AcquireToken() función. En los ejemplos siguientes se describen algunas maneras de adquirir el token.

  • Last updated on