Dela via

Viktig information

  • Artikel

Viktigt

Versioner av Microsoft Rights Management Service SDK som släpptes före mars 2020 är inaktuella. program som använder tidigare versioner måste uppdateras för att använda mars 2020-versionen. Fullständig information finns i utfasningsmeddelandet.

Inga ytterligare förbättringar planeras för Microsoft Rights Management Service SDK. Vi rekommenderar starkt att du använder Microsoft Information Protection SDK för klassificerings-, märknings- och skyddstjänster.

Den här artikeln innehåller viktig information om den här och tidigare versioner av RMS SDK 2.1.

Oktober 2019 – uppdatering

  • I vissa fall går det inte att autentisera användaren med Azure RMS med hjälp av symmetrisk nyckelautentisering, vilket förhindrar skydd och avskydd av innehåll.
  • RMS-klienten kan krascha när du försöker kontrollera om vissa PDF-dokument som tidigare har skyddats och är oskyddade för närvarande är skyddade.
  • Det fungerar inte korrekt att använda DNS-omdirigering för AD RMS-servrar som har konfigurerats på särskilda portar.

September 2019 – uppdatering

  • Ett dödläge som kan uppstå vid försök att anropa initieringsmetoderna har åtgärdats samtidigt som vissa andra RMS-klientmetoder.
  • Ett problem med att avgöra om lösenordsskyddade Office filer är RMS-skyddade har åtgärdats.
  • Uppdatera licensieringsvalidering för särskilda licenser.
  • Uppdateringar av PDF-skyddet.
  • Andra felkorrigeringar.
  • Uppdatera för att länka statiskt mot C-körningsbiblioteken.

April 2019 – uppdatering

  • Felkorrigeringar i fil-API:et.
  • Fil-API:et har uppdaterats för att kontrollera EXPORT-rättigheten i stället för RÄTTIGHETEN EXTRAHERA vid dekryptering av innehåll.
  • Installationskorrigering för att säkerställa att det nya PDF v2-skyddet installeras vid uppgraderingen.
  • Telemetriändringar. Den här ändringen krävde en uppdatering av installationspaketet som installerar C-körningsbiblioteken.
  • Ändringar i tjänstserverdelsautentiseringen. Uppdatera till den här SDK-versionen för att minimera störningar om du använder symmetrisk nyckelautentisering för dina program
  • Stöd för VC 15.9

Oktober 2017 – uppdatering

Februari 2016 – SDK-dokumentationsuppdatering

Anteckning

Uppdateringarna av funktionsdokumentationen i det här avsnittet gäller SDK-hämtningen från 2015-11-12.

  • Förbättrat autentiseringsflöde – med OAuth2-tokenbaserad autentisering via Azure Active Directory Authentication Library (ADAL). Mer information om den här processen och API-tilläggen för den finns i ADAL-autentisering för ditt RMS-aktiverade program.

  • Uppdatering av ADAL - Genom att uppdatera programmet så att ADAL-autentisering används i stället för inloggningsassistenten för Microsoft Online kan du och dina kunder göra följande:

    • Använda multifaktorautentisering
    • Installera RMS 2.1-klienten utan administratörsbehörighet för datorn
    • Certifiera ett program för Windows 10

  • Stöd för Microsoft Online-inloggningsassistent (SIA) med RMS SDK tas bort. Vi kommer att fortsätta att stödja användningen av SIA i sex månader efter det att stödet upphör.

Uppdatering under december 2015

  • Prestandaförbättringar har införts på flera områden, inklusive:

    • Publicera från den primära licensieringsservern när endast licens-servrar används.
    • RMS SDK 2.1 visar fel snabbare när det inte finns någon nätverksanslutning.

  • Många uppdateringar för att förbättra felmeddelandena och felsökningsfunktionen.

  • Observera också att listan över plattformar som stöds också har uppdaterats.

  • Behovet av förproduktionsmiljön och användningen av ett programmanifest har tagits bort från RMS SDK 2.1. Dessa avsnitt ur den här utvecklar-dokumentationsuppsättningen har tagits bort och den övergripande dokumentationen har förenklats och organiserats om.

Uppdatering under maj 2015

Uppdatering under april 2015

  • Dokumentspårning är nu möjligt via en uppsättning nya API:er. Mer information finns i Spåra innehåll.

  • Krypteringstyp - Vi stöder nu kontroll på API-nivå över val av krypteringspaket. Mer information finns i Arbeta med kryptering.

    Observera Vi kommer inte längre att exponera flaggan IPC_LI_DEPRECATED_ENCRYPTION_ALGORITHMS i vårt API. Det innebär att framtida appar inte kan kompileras om de refererar till den här flaggan men appar som redan har byggts fortsätter att fungera eftersom vi hanterar flaggan privat i API-koden. Fördelen med den gamla föråldrade krypteringsalgoritmflaggan kan fortfarande uppnås genom att enkelt ändra en flagga. Mer information finns i Arbeta med kryptering.

  • Serverlägesprogram, de som använder api-lägesvärden förIPC_API_MODE_SERVER, behöver inte längre ett programmanifest. Du kan testa ditt program mot en RMS-produktionsserver och du behöver inte skaffa någon produktionslicens när du växlar till produktionsmiljön. Mer information om serverlägesprogram finns i Programtyper.

  • Loggning implementeras nu via både fil- och händelsespårning för Windows-metoder.

  • Om du kör på en Windows 7 SP1- eller Windows Server 2008 R2-dator läser du kommentaren under se på följande under "Viktiga kommentarer för utvecklare".

Uppdatering under januari 2015

  • Stöd för ökad storlek på skyddade filer (pfile) - Nytt stöd för pfile-filer som är större än 1 GB. Mer information om pfile-filer finns i Filformat som stöds.

  • Förbättrad loggning för bättre diagnostik - Loggningsnivåer visar FEL eller VARNING för meddelanden som ska granskas. Alla andra meddelanden, inklusive undantag som fortfarande visas, loggas som INFO.

    Vi valde att göra på det här sättet så att du inte går miste om någon detaljerad information. Nu visas bara viktiga meddelanden med nivån VARNING.

  • Anskaffa företagsmallar - Betydande korrigeringar av mallanskaffningskoden baserat på kundrapporter och feedback.

  • Högre grad av lokaliseringskonsekvens

Uppdatering under oktober 2014

Uppdatering under juli 2014

Fil-API-komponenten i SDK har utökats och erbjuder följande funktioner:

Uppdatering under april 2014

  • API-filminnesanvändning har, särskilt för stora pfile-filer, förbättrats avsevärt.

  • Innehålls-ID kan nu skrivas via egenskapen IPC_LI_CONTENT_ID. Mer information finns i licensegenskapstyper.

  • Krav på produktionsmanifest - Vi kräver inte längre ett manifest när ditt RMS-aktiverade program/tjänst körs i serverläge. Mer information finns i Programtyper.

  • Dokumentationsuppdateringar

    Testa bästa praxis - Vägledning lades till för användning av en lokal server före test med Azure RMS. Mer information finns i Aktivera ditt tjänstprogram så att det fungerar med molnbaserat RMS.

Viktiga kommentarer för utvecklare

  • Inbyggt stöd för alla filtyper

    Inbyggt stöd kan läggas till för varje filtyp (tillägg) med den här versionen av Rights Management Services SDK 2.1. För alla tillägg <ext> (icke-office och pdf) används till exempel *.pext>< om administratörskonfigurationen för tillägget är "NATIVE".

    Mer information om filtyper som stöds finns i Fil-API-konfiguration.

  • För datorer med Windows 7 SP1 och Windows Server 2008 R2 SP1 men utan uppdateringen KB2533623 kan följande fel inträffa vid skydd av Office-filer: "Parametern är felaktig. Felkod: 0x80070057". Om du ser det här felet installerar du uppdateringen och försöker igen. Om det fortfarande uppstår problem kontaktar du RMS SDK Beta Feedback-aliaset rmcstbeta@microsoft.com.

    Observera Från och med april 2015-versionen har en kontroll lagts till i installationsprocessen för denna KB.

  • API-filintegration

    Active Directory Rights Management Services File API, med tillägget av API:t för filer, har nu följande fördelar och funktioner.

    • Du kan skydda konfidentiella data på ett automatiserat sätt utan att behöva känna till hur detaljerna i IRM-implementationen (Information Rights Management) används av olika filformat.

    • Microsoft Office-filer, PDF-filer (Portable Document Format) och andra valda filtyper kan skyddas med det inbyggda skyddet. En fullständig lista över filtyper som kan skyddas med internt skydd finns i Fil-API-konfiguration.

    • Alla filer, utom systemfiler och Office-filer, kan skyddas med det RMS-skyddade filformatet (PFile).

    Fil-API:et implementeras via följande fyra nya funktioner: IpcfDecryptFile, IpcfEncryptFile, IpcfGetSerializedLicenseFromFile och IpcfIsFileEncrypted.

    Fil-API kräver att Rights Management Service Client 2.1 är installerad på klientdatorn och att datorn är ansluten till en RMS-server. Mer information om RMS-servern, RMS-klienten och deras funktioner finns i TechNet-innehållet i RMS-dokumentationen för IT-proffs.

  • Problem: När du skapar en licens från början måste äganderättigheter beviljas explicit.

    Lösning: Ditt program måste explicit lägga till ägarrättigheter till licensägaren när en licens skapas från början med IpcCreateLicenseFromScratch. Mer information finns i Lägga till explicita ägarrättigheter.

  • Problem: Om ett program anropar IpcProtectWindow eller IpcUnprotectWindow två gånger för samma fönster med hjälp av dess handtag returnerar RMS SDK 2.1 ett fel i HRESULT.

    Lösning: Specifik vägledning om detta finns i avsnittet Kommentarer i IpcProtectWindow och IpcUnprotectWindow.

  • Problem: När du bygger för flera konfigurationer måste du använda den här vägledningen.

    Lösning: Om du vill använda Ipcsecproc*isv.dll för en annan arkitektur (till exempel du har installerat 64-bitars SDK:n på en 64-bitarsdator men nu vill distribuera på en 32-bitarsdator som kräver Ipcsecproc*isv.dll), måste du installera 32-bitars SDK:n på en annan dator och kopiera Ipcsecproc*isv.dll filer till den från "%PROGRAMFILES%\Microsoft Information Protection And Control"-mappen (standardplatsen eller var du än väljer att installera SDK).

Vanliga frågor och svar

Fråga: Hur fungerar standardspråkfunktionerna med funktioner som använder en LCID-parameter?

Svar: Använd 0 om standardspråk. I det här fallet kan AD RMS Client 2.1 leta upp namn och beskrivningar i följande ordning och hämta det första tillgängliga:

  1. Användaren önskade LCID.
  2. Systemspråket LCID.
  3. Det första tillgängliga språket som anges i RMS-mallen (Rights Management Server).

Om inget namn eller beskrivning kan hämtas returneras ett fel. Det får bara finnas ett namn och en beskrivning för en specifik LCID.