CSJCurrent de:V5.0.1

Aus Cryptshare Documentation
Version vom 13. Oktober 2021, 11:17 Uhr von Maintenance script (Diskussion | Beiträge) (Imported from text file)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche



Neue Funktionen

Verifizierungsspeicher

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`.
    • 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.LOCAL_MACHINE` 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.

QUICK

Die API wurde um einige Methoden und Eigenschaften erweitert, die für die Nutzung von QUICK relevant sind. Transfer zurückziehen Es ist nun möglich, einen Transfer zurückzuziehen, sodass die dazugehörigen Dateien für die Empfänger nicht weiter zugänglich sind. Um einen Transfer zurückzurufen, müssen Sie lediglich eine beliebige Überladung von `Client.revokeTransfer` aufrufen und, falls notwendig, angeben, ob der Absender/Empfänger per E-Mail über den Rückzug des Transfers informiert werden soll. Optional können Sie eine Nachricht als Parameter übergeben, um den Standardbenachrichtigungstext mit einer benutzerdefinierten Nachricht zu ersetzen.

Bereitstellen einer eigenen `IProtectionService`-Implementierung für den Schutz der Client Store

Es besteht nun die Möglichkeit, eine eigene `IProtectionService`-Implementierung für den Schutz der Client Store bereitzustellen. Wir stellen auch die Referenzimplementierung `AesProtectionService` bereit, welche es erlaubt, die Client Store mittels AES-Verschlüsselung und einem ausgewählten `IKeySourceProvider` zu schützen. Auch für den `IKeySourceProvider` bieten wir die Referenzimplementierung an.

Neue Upload-Callbacks

Es wurden neue Callback-Parameter für die Methoden `Client.performTransfer` und `Client.beginTransfer` eingeführt. Diese Handler werden bei Statusänderungen des Transfers aufgerufen. Zusammenfassend lässt sich sagen, dass zwischen den Aufrufen zu `I``UploadFilesFinishedHandler` und `I``UploadCompletedHandler` der Server diverse Verarbeitungen wie z.B. Dateiverschlüsselung durchführt.

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 Java API v5 einsetzen, sollten Sie dafür sorgen, dass eine eventuell aus einer vergangenen Version bestehende client.store Datei gelöscht wird.
  • Der Namespace com.befinesolutions.cryptshare.aping `wurde in` com.c`ryptshare.api` umbenannt.
  • Die minimal erforderliche Cryptshare Server für die Verwendung der Java API ist die Version 4.5.0.