class ProtectionHandler

  • Artykuł
  • Czas czytania: 3 min

Zarządza akcjami związanymi z ochroną w konkretnej konfiguracji ochrony.

Podsumowanie

Członkowie Opisy
public std::shared_ptr < Stream > CreateProtectedStream(const std::shared_ptr < Stream >& backingStream, int64_t contentStartPosition, int64_t contentSize) Utwórz chroniony strumień, który będzie umożliwiał szyfrowanie/odszyfrowywanie zawartości.
public int64_t EncryptBuffer(int64_t offsetFromStart, const uint8_t* inputBuffer, int64_t inputBufferSize, uint8_t* outputBuffer, int64_t outputBufferSize, bool isFinal) Zaszyfruj bufor.
public int64_t DecryptBuffer(int64_t offsetFromStart, const uint8_t* inputBuffer, int64_t inputBufferSize, uint8_t* outputBuffer, int64_t outputBufferSize, bool isFinal) Odszyfrowywanie buforu.
public int64_t GetProtectedContentLength(int64_t unprotectedLength, bool includesFinalBlock) Oblicza rozmiar (w bajtach) zawartości, jeśli powinna zostać zaszyfrowana za pomocą tego protectionHandler.
public int64_t GetBlockSize() Pobiera rozmiar bloku (w bajtach) dla trybu szyfrowania używanego przez ten ProtectionHandler.
public std::vector < std::string > GetRights() const Pobiera prawa przyznane użytkownikowi/tożsamości skojarzonej z tą ochronąHandler.
public bool AccessCheck(const std::string & right) const Sprawdza, czy program obsługi ochrony udziela użytkownikom dostępu do określonych praw.
const publiczny std::string GetIssuedTo() Pobiera użytkownika skojarzonego z programem obsługi ochrony.
const publiczny std::string GetOwner() Otrzymuje adres e-mail właściciela zawartości.
bool publiczny IsIssuedToOwner() Pobiera, jeśli bieżący użytkownik jest właścicielem zawartości.
public std::shared_ptr < ProtectionDescriptor > GetProtectionDescriptor() Uzyskuje szczegółowe informacje o ochronie.
const public std::string GetContentId() Pobiera identyfikator unikatowy dla dokumentu/zawartości.
bool publiczny DoesUseDeprecatedAlgorithms() Pobiera, jeśli program obsługi ochrony używa przestarzałych algorytmów szyfrowania (FUNKCJA.TYG) w celu zachowania zgodności z poprzednimi wersjami.
bool publiczny IsAuditedExtractAllowed() Pobiera, jeśli program obsługi ochrony udziela użytkownikowi "inspekcji wyodrębnienia" w odpowiedni sposób.
const public std::vector < uint8_t >& GetSerializedPublishingLicense() const Serialize ProtectionHandler do licencji publikowania (PL)
const std::vector < uint8_t >& GetSerializedPreLicense(PreLicenseFormat format) const Uzyskaj wstępną licencję.
publiczna const CipherMode GetCipherMode() Pobiera tryb szyfrowania programu obsługi ochrony.
wylicz.przedlicencjonowanieFormat Format licencji wstępnej.

Członkowie

CreateProtectedStream, funkcja

Utwórz chroniony strumień, który będzie umożliwiał szyfrowanie/odszyfrowywanie zawartości.

Parametry:

  • backingStream:strumienia kopii zapasowej, z którego odczyt/zapis

  • contentStartPosition:pozycja początkowa (w bajtach) w strumieniu kopii zapasowej, gdzie zaczyna się zawartość chroniona

  • contentSize:Rozmiar (w bajtach) zawartości chronionej w strumieniu kopii zapasowej

Zwraca:strumień chroniony

Funkcja EncryptBuffer

Zaszyfruj bufor.

Parametry:

  • offsetFromStart:względna pozycja inputBuffer od samego początku zawartości zwykłego tekstu

  • inputBuffer:Bufor zawartości cleartext, która zostanie zaszyfrowana

  • inputBufferSize:Rozmiar buforu wejściowego (w bajtach)

  • outputBuffer:Bufor, do którego zostanie skopiowana zaszyfrowana zawartość

  • outputBufferSize:Rozmiar (w bajtach) buforu wyjściowego

  • isFinal:Jeśli bufor wprowadzania zawiera ostatnie bajty czytelnego tekstu lub nie

Zwraca:Rzeczywisty rozmiar zaszyfrowanej zawartości (w bajtach)

Funkcja DecryptBuffer

Odszyfrowywanie buforu.

Parametry:

  • offsetFromStart:względna pozycja pola wprowadzaniaNajedna od samego początku zaszyfrowanej zawartości

  • inputBuffer:Bufor zaszyfrowanej zawartości, która zostanie odszyfrowana

  • inputBufferSize:Rozmiar buforu wejściowego (w bajtach)

  • outputBuffer:Bufor, do którego zostanie skopiowana odszyfrowana zawartość

  • outputBufferSize:Rozmiar (w bajtach) buforu wyjściowego

  • isFinal:Jeśli bufor wejściowy zawiera końcowe zaszyfrowane bajty lub nie

Zwraca:Rzeczywisty rozmiar odszyfrowania zawartości (w bajtach)

GetProtectedContentLength, funkcja

Oblicza rozmiar (w bajtach) zawartości, jeśli powinna zostać zaszyfrowana za pomocą tego protectionHandler.

Parametry:

  • unprotectedLength:Rozmiar niechronionej zawartości (w bajtach)

  • includesFinalBlock:Opisuje, czy dane niechronione treści zawierają końcową blokadę. Na przykład w trybie szyfrowania CBC4k nieochronione bloki niechronione mają taki sam rozmiar jak bloki niechronione, ale bloki chronione finalnie są większe niż ich niechronione odpowiedniki.

Zwraca:Rozmiar zawartości chronionej (w bajtach)

GetBlockSize, funkcja

Pobiera rozmiar bloku (w bajtach) dla trybu szyfrowania używanego przez ten ProtectionHandler.

Zwraca:Rozmiar bloku (w bajtach)

GetRights, funkcja

Pobiera prawa przyznane użytkownikowi/tożsamości skojarzonej z tą ochronąHandler.

Zwroty:prawa przyznane użytkownikowi

AccessCheck, funkcja

Sprawdza, czy program obsługi ochrony udziela użytkownikom dostępu do określonych praw.

Parametry:

  • right: Right to check

Zwraca:Jeśli program obsługi ochrony udziela użytkownikowi dostępu do określonych praw lub nie

GetIssuedTo, funkcja

Pobiera użytkownika skojarzonego z programem obsługi ochrony.

Zwraca:Użytkownik skojarzony z programem obsługi ochrony

Funkcja GetOwner

Otrzymuje adres e-mail właściciela zawartości.

Zwraca:adres e-mail właściciela zawartości

IsIssuedToOwner, funkcja

Pobiera, jeśli bieżący użytkownik jest właścicielem zawartości.

Zwraca:jeśli bieżący użytkownik jest właścicielem zawartości lub nie

Funkcja GetProtectionDescriptor

Uzyskuje szczegółowe informacje o ochronie.

Zwroty:Szczegóły ochrony

GetContentId, funkcja

Pobiera identyfikator unikatowy dla dokumentu/zawartości.

Zwraca:unikatowy identyfikator zawartości

DoesUseDeprecatedAlgorithms, funkcja

Pobiera, jeśli program obsługi ochrony używa przestarzałych algorytmów szyfrowania (FUNKCJA.TYG) w celu zachowania zgodności z poprzednimi wersjami.

Zwraca:Jeśli program obsługi ochrony używa przestarzałych algorytmów szyfrowania lub nie

IsAuditedExtractAllowed, funkcja

Pobiera, jeśli program obsługi ochrony udziela użytkownikowi "inspekcji wyodrębnienia" w odpowiedni sposób.

Funkcje zwracane:Jeśli program obsługi ochrony udziela użytkownikowi prawa "wyodrębniania pod inspekcją" lub nie

GetSerializedPublishingLicense, funkcja

Serialize ProtectionHandler do licencji publikowania (PL)

Zwraca:Licencja publikowania szeregowego

GetSerializedPreLicense, funkcja

Uzyskaj wstępną licencję.

Parametry:

  • format:format przed licencją

Zwraca:Wstępna licencja seryjna Licencja wstępna umożliwia użytkownikowi natychmiastowe korzystanie z zawartości bez konieczności na potrzeby dodatkowego połączenia HTTP. Element ProtectionHandler musi zostać utworzony przy użyciu wartości [ProtectionHandler::P ublishingSettings::SetPreLicenseUserEmail lub w innym przypadku spowoduje zwrócenie pustego wektora.

GetCipherMode, funkcja

Pobiera tryb szyfrowania programu obsługi ochrony.

Zwraca:tryb szyfrowania

PreLicenseFormat wylicz

Wartości Opisy
Xml Starszy format XML/SOAP używany przez MSIPC
Json Format JSON/REST używany przez zestaw SDK MIP i zestaw SDK RMS

Format przed licencją.t.