CSDNCurrent de:V4.0.0

---

Neue Funktionen

• Die API wurde um einige Methoden und Eigenschaften erweitert, die für die Nutzung von QUICK relevant sind. Für einen Leitfaden zur Durchführung eines QUICK Transfers empfehlen wir Ihnen den Artikel "QUICK Transfer versenden".
• Das Verhalten des Verifizierungsspeichers wurde verbessert. Bitte beachten Sie die nicht-abwärtskompatiblen Änderungen bezüglich des Verifizierungsspeichers weiter unten.
  • Bei Angabe eines Pfades zu einem Verifizierungsspeicher verwendet die `Client`-Instanz nun eine Standardimplementierung eines `IStore`, welche intern von der Microsoft Data Protection API Gebrauch macht, um den Inhalt des Verifizierungsspeichers zu schützen.
    • Ein zusätzlicher `ProtectionScope` Parameter kann übergeben werden, welcher angibt, ob der Verifizierungsspeicher auf Maschinenbasis oder Domänennutzerbasis geschützt werden soll. Wenn kein `ProtectionScope` übergeben wird, wird standardmäßig `ProtectionScope.LocalMachine` verwendet, sodass verschiedene Domänennutzer auf einer Maschine auf den Verifizierungsspeicher zugreifen können.
  • Alternativ kann dem `Client`-Konstruktor ein zusätzlicher `IStore` Parameter anstelle eines Verifizierungsspeicher-Pfades übergeben werden. Dieses Interface beschreibt eine Datenstruktur, die das Setzen, Erhalten, Löschen von Schlüssel-Wert-Paaren und persistente Speichern des Inhalts ermöglicht.
• Eine parameterlose Überladung von `Client.CheckCompatibility` wurde eingeführt, die eine Kompatibilitätsprüfung gegen den Cryptshare Server ausführt. Dabei wird gegen eine von der API vorausgesetzte Mindestversion des Cryptshare Servers geprüft.
• Der Client unterstützt nun auch die Verifizierung von einzelnen Nutzer-E-Mail-Adressen in Verbindung mit verschiedenen Cryptshare Server URLs. Diese Änderung ermöglicht es, abhängig von der angegebenen Cryptshare Server URL mehrere Verifizierungstokens für eine einzelne Nutzer-E-Mail-Adresse aufzubewahren.

Nicht-abwärtskompatible Änderungen

Bestehende client.store Dateien sind nicht mehr gültig!

Aufgrund diverser interner Umstellungen bezüglich des Verifizierungsspeichers sind existierende client.store Dateien nicht mehr kompatibel! Bevor Sie die Cryptshare .NET API v4 einsetzen, sollten Sie dafür sorgen, dass eine eventuell aus einer vergangenen Version bestehende client.store Datei gelöscht wird.

• Das Zielframework der API wurde von .NET Framework v4.0 auf v4.5 geändert.
• Diverse Methoden/Eigenschaften wurden umbenannt oder verändert, um die Struktur der API zu vereinheitlichen
  • Die Namespaces `BefineSolutions.Cryptshare.API` `und BefineSolutions.Cryptshare.Web` wurden zusammengeführt und in `Cryptshare.API` umbenannt.
  • Die Sichtbarkeit von `ToolBox` und `ClientUtils` wurde auf `internal` umgestellt.
  • `Policy.AllowedStandardPasswordModes`
    • gibt nun ein `ICollection<PasswordMode>` statt `passwordMode[]` zurück
  • `Policy.FailedAddresses`
    • wurde unbenannt in `Policy.FailedEmailAddresses`
    • gibt nun ein `ICollection<string>` statt `string[]` zurück
  • `ServerData.AdminEmails`
    • wurde unbenannt in `ServerData.AdminEmailAddresses`
    • gibt nun ein `ICollection<string>` statt `string[]` zurück
  • `ServerData.AdminLocale`
    • gibt nun ein `CultureInfo` statt `string` zurück
  • `LicenseInfo.ServerLicenseExpirationDate`
    • gibt nun ein `DateTime?` statt `string` zurück
  • `LicenseInfo.ServerSubscriptionExpirationDate`
    • gibt nun ein `DateTime?` statt `string` zurück
  • `LicenseInfo.ProductLicenseExpirationDate`
    • gibt nun ein `DateTime?` statt `string` zurück
  • `LicenseInfo.ProductSubscriptionExpirationDate`
    • gibt nun ein `DateTime?` statt `string` zurück
  • `LanguagePack.LastUpdate`
    • gibt nun ein `DateTime` statt `long` zurück
  • `Client.RequestMailTemplate`
    • wurde unbenannt in `Client.RequestEmailTemplate`
    • gibt nun ein `IDictionary<ICollection<string>, string>` statt `MailTemplateResult zurück`
    • der `replacements` Parameter ist nun ein `IDictionary<ICollection<string>, ICollection<TemplateReplacement>>` statt `IDictionary<ISet<String>, ISet<TemplateReplacement>>`
    • der `emailFormat` Parameter ist nun ein `Cryptshare.API.EmailFormat` statt `String`
  • `Client.SenderLanguage`
    • wurde unbenannt in `Client.UserLanguage`
  • `Client.RequestTermsOfUse`
    • gibt nun ein `Cryptshare.API.TermsOfUse` zurück
  • `Client.RequestAddonSettings`
    • gibt nun ein `IDictionary<string, AddonOptionValue>` statt `AddonSettingsResult` zurück
  • `Client.RequestPassword`
    • wurde unbenannt in `RequestGeneratedPassword`
    • gibt nun das Passwort als `string` zurück
  • `Client.CheckPassword`
    • gibt nun ein `PasswordCheckResult` statt `PasswordPolicy` zurück
      • Use `Client.RequestPasswordPolicy` if you want to retrieve the password policies
  • `Client.RequestLanguagePack`
    • gibt nun ein `ICollection` statt `List` zurück
  • `Client.UploadCompleteHandler`
    • akzeptiert nun ein `IDictionary` statt `Dictionary`
  • Client.`UploadCanceldHandler`
    • wurde unbenannt in `UploadCancelledHandler`
  • `Client.UpdateTransferError`
    • Rückgabewert wurde von `string` auf `void` umgestellt
      • Wenn der Methodenaufruf erfolgreich war, wird nichts zurückgegeben; andernfalls wird eine Exception geworfen.
  • `CryptshareConnetion.ComputeIdentifier`
    • benötigt keine Parameter mehr
  • `TransferError`
    • alle Eigenschaften sind nun `ICollection`s statt `List`en
  • `Transfer.SendMails`
    • wurde umbenannt in `Transfer.SendEmails`
  • `Transfer.PasswordMode`
    • der Typ wurde geändert von `enum Cryptshare.Generated.WebService.passwordMode` in `enum Cryptshare.API.PasswordMode`
  • `Transfer.ClassificationID`
    • wurde umbenannt in `Transfer.ClassificationId`
  • `Transfer.TrackingID`
    • wurde umbenannt in `Transfer.TrackingId`
  • `Transfer.SessionId`
    • wurde entfernt, da diese Eigenschaft aus der Sicht eines API-Konsumenten keinen Zweck erfüllt

---