Interface IDVDV2Manager
Zentrale Klasse der DVDV-Bibliothek, kapselt die Kommunikation mit dem DVDV2-Server sowie das Failover, also den Wechsel zu einem anderen DVDV2-Server im Fehlerfall.
Ein typisches Fachverfahren wird genau ein Objekt dieses Typs erzeugen und das dann in der ganzen Anwendung dauerhaft verwenden, also ggf. auch in verschiedenen Threads. Wenn Sie davon abweichen, sollten Sie bedenken, dass verschiedene Objekte dieses Typs unabhaengig voneinander (und damit i.d.R. ueberfluessige) Authentifizierungsrequests machen.
Entspricht in etwa der DVDV1-Klasse
DVDVManager.
Namespace: Dvdv.Api.Manager
Assembly: Dvdv.dll
Syntax
public interface IDVDV2Manager
Methods
| Edit this page View SourceAddFailoverListener(IFailoverListener)
Registiert den angegebenen IFailoverListener, damit diese im Failover-Fall benachrichtigt wird. Auf diese Weise kann Ihr Anwendungscode auf Failover-Ergeignisse reagieren, etwa für Profiling-Zwecke.
Declaration
void AddFailoverListener(IFailoverListener listener)
Parameters
| Type | Name | Description |
|---|---|---|
| IFailoverListener | listener | den zu registrierenden Listener |
CreateCategoryRequest(string)
Erzeugt eine Instanz für den Aufruf von FindServiceSpecificationUrisByCategory.
Declaration
ICategoryRequest CreateCategoryRequest(string category)
Parameters
| Type | Name | Description |
|---|---|---|
| string | category | Kategorienname, z.B. 'Meldebehörde' |
Returns
| Type | Description |
|---|---|
| ICategoryRequest | Frisches Objekt vom Typ ICategoryRequest |
CreateFindAuthorityDescriptionRequest(string, string)
Diese Methode wird mittelfristig zugunsten der funktionsgleichen Methode
CreateFindOrganizationDescriptionRequest(String, String) entfernt werden.
Declaration
IFindOrganizationDescriptionRequest CreateFindAuthorityDescriptionRequest(string organizationKey, string category)
Parameters
| Type | Name | Description |
|---|---|---|
| string | organizationKey | den DVDV-Organisationsschlüssel |
| string | category | die DVDV-Organisationskategorie, z.B. 'Meldebehörde' |
Returns
| Type | Description |
|---|---|
| IFindOrganizationDescriptionRequest | passende Instanz der gefundenen Behörde oder null, wenn es keine entsprechende Behörde gibt |
CreateFindCategoriesRequest(string, string)
Erzeugt Instanz für den Aufruf von findCategories.
Declaration
IFindCategoriesRequest CreateFindCategoriesRequest(string fingerPrint, string organizationKey)
Parameters
| Type | Name | Description |
|---|---|---|
| string | fingerPrint | den fingerPrint, siehe
|
| string | organizationKey | den DVDV-Organisationsschlüssel |
Returns
| Type | Description |
|---|---|
| IFindCategoriesRequest | passende Instanz für den Aufruf von findCategories |
CreateFindCertificateByFingerprintRequest(string)
Erzeugt eine Instanz für den Aufruf von FindCertificateByFingerprint.
Declaration
IFindCertificateByFingerprintRequest CreateFindCertificateByFingerprintRequest(string fingerPrint)
Parameters
| Type | Name | Description |
|---|---|---|
| string | fingerPrint | den fingerPrint, siehe
|
Returns
| Type | Description |
|---|---|
| IFindCertificateByFingerprintRequest | Frisches Objekt vom Typ IFindCertificateByFingerprintRequest |
CreateFindOrganizationDescriptionRequest(string, string)
Erzeugt Instanz für den Aufruf von FindOrganizationDescription. Entspricht in etwa der DVDV1-Methode
DVDVManager.CreateFindAuthorityDescriptionRequest.
Declaration
IFindOrganizationDescriptionRequest CreateFindOrganizationDescriptionRequest(string organizationKey, string category)
Parameters
| Type | Name | Description |
|---|---|---|
| string | organizationKey | den DVDV-Organisationsschlüssel |
| string | category | die DVDV-Organisationskategorie, z.B. 'Meldebehörde' |
Returns
| Type | Description |
|---|---|
| IFindOrganizationDescriptionRequest | passende Instanz für den Aufruf von FindOrganizationDescription |
CreateFindOrganizationDescriptionsRequest(string)
Erzeugt Instanz für den Aufruf von FindOrganizationDescriptions und benötigt daher im Gegensatz zu CreateFindOrganizationDescriptionRequest keinen Kategorienamen als Parameter.
Declaration
IFindOrganizationDescriptionsRequest CreateFindOrganizationDescriptionsRequest(string organizationKey)
Parameters
| Type | Name | Description |
|---|---|---|
| string | organizationKey | den DVDV-Organisationsschlüssel |
Returns
| Type | Description |
|---|---|
| IFindOrganizationDescriptionsRequest | passende Instanz für den Aufruf von FindOrganizationDescriptions |
CreateFindOrganizationsByCustomServiceElementRequest(string, ServiceElementParameterType, string)
Erzeugt eine Instanz für den Aufruf von FindOrganizationsByServiceElement für einen konfigurierbaren Dienstelementtyp.
Declaration
IFindOrganizationsByServiceElementRequest CreateFindOrganizationsByCustomServiceElementRequest(string customServiceElementType, ServiceElementParameterType parameterType, string parameterValue)
Parameters
| Type | Name | Description |
|---|---|---|
| string | customServiceElementType | Der konfigurierbare Typ des Dienstelementes, z.B. 'Bezahldienst-Server' |
| ServiceElementParameterType | parameterType | Der Parameter des Dienstelementes der überprüft werden soll, möglich sind hier: CIPHER_CERTIFICATE, SIGNATURE_CERTIFICATE, URI. Nicht alle Dienstelemente bieten alle Parametertypen an. |
| string | parameterValue | Der Wert des Parameters, auf den verglichen wird. Bei CIPHER_CERTIFICATE oder SIGNATURE_CERTIFICATE der Fingerprint in Hexadezimaldarstellung, bei URI der URI-String. |
Returns
| Type | Description |
|---|---|
| IFindOrganizationsByServiceElementRequest | passende Instanz für den Aufruf von FindOrganizationsByServiceElement |
CreateFindOrganizationsByServiceElementRequest(ServiceElementType, ServiceElementParameterType, string)
Erzeugt eine Instanz für den Aufruf von FindOrganizationsByServiceElement für einen eingebauten Dienstelementtyp.
Declaration
IFindOrganizationsByServiceElementRequest CreateFindOrganizationsByServiceElementRequest(ServiceElementType serviceElementType, ServiceElementParameterType parameterType, string parameterValue)
Parameters
| Type | Name | Description |
|---|---|---|
| ServiceElementType | serviceElementType | Der Typ des Dienstelementes, möglich sind hier OSCI_INTERMEDIARY, OSCI_ADDRESSEE, CIPHER_CERTIFICATE, SIGNATURE_CERTIFICATE, WEBSERVER |
| ServiceElementParameterType | parameterType | Der Parameter des Dienstelementes der überprüft werden soll, möglich sind hier: CIPHER_CERTIFICATE, SIGNATURE_CERTIFICATE, URI. Nicht alle Dienstelemente bieten alle Parametertypen an. |
| string | parameterValue | Der Wert des Parameters, auf den verglichen wird. Bei CIPHER_CERTIFICATE oder SIGNATURE_CERTIFICATE der Fingerprint in Hexadezimaldarstellung, bei URI der URI-String. |
Returns
| Type | Description |
|---|---|
| IFindOrganizationsByServiceElementRequest | passende Instanz für den Aufruf von FindOrganizationsByServiceElement |
CreateFindServiceDescriptionRequest(string, string)
Erzeugt Instanz für den Aufruf von findServiceDescription. Entspricht in etwa der DVDV1-Methode
DVDVManager.CreateFindServiceDescriptionRequest.
Declaration
IFindServiceDescriptionRequest CreateFindServiceDescriptionRequest(string organizationKey, string serviceSpecificationUri)
Parameters
| Type | Name | Description |
|---|---|---|
| string | organizationKey | den DVDV-Organisationsschlüssel |
| string | serviceSpecificationUri | die serviceSpecificationUri |
Returns
| Type | Description |
|---|---|
| IFindServiceDescriptionRequest | passende Instanz für den Aufruf von findServiceDescription |
CreateVerifyCategoryRequest(string, string)
Erzeugt Instanz für den Aufruf von verifyCategory. Entspricht in etwa der DVDV1-Methode
DVDVManager.CreateVerifyCategoryRequest.
Declaration
IVerifyCategoryRequest CreateVerifyCategoryRequest(string fingerPrint, string category)
Parameters
| Type | Name | Description |
|---|---|---|
| string | fingerPrint | den fingerPrint, siehe
|
| string | category | die DVDV-Organisationskategorie, z.B. 'Meldebehörde' |
Returns
| Type | Description |
|---|---|
| IVerifyCategoryRequest | passende Instanz für den Aufruf von #verifyCategory |
Exceptions
| Type | Condition |
|---|---|
| DVDVException | wird geworfen wenn ein Fehler aufgetreten ist |
FindAuthorityDescription(IFindOrganizationDescriptionRequest)
Diese Methode wird mittelfristig zugunsten der funktionsgleichen Methode
FindOrganizationDescription(IFindOrganizationDescriptionRequest) entfernt werden.
Declaration
OrganizationDescription FindAuthorityDescription(IFindOrganizationDescriptionRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindOrganizationDescriptionRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| OrganizationDescription | die abgerufenen Organisationen |
Exceptions
| Type | Condition |
|---|---|
| DVDVNoHitsException | wird geworfen, wenn eine Anfrage gestellt wurde, die keine Treffer liefert |
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindAuthorityDescription(List<IFindOrganizationDescriptionRequest>)
Diese Methode wird mittelfristig zugunsten der funktionsgleichen Methode
FindOrganizationDescription(IFindOrganizationDescriptionRequest) entfernt werden.
Declaration
List<OrganizationDescription> FindAuthorityDescription(List<IFindOrganizationDescriptionRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IFindOrganizationDescriptionRequest> | requests | die Request - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<OrganizationDescription> | die abgerufenen Organisationen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen, wenn ein anderer Fehler aufgetreten ist |
FindCategories(IFindCategoriesRequest)
Liefert Liste aller Organisationskategorien, für die die es eine Organisation gibt, die ein Client-Zertifikat mit dem angegebenen Fingerprint besitzt und den angegebenen Organisationsschlüssel besitzt. Das Ergebnis ist eine Liste von Kategoriennamen (typischerweise mit höchstens einem Eintrag).
Declaration
List<string> FindCategories(IFindCategoriesRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindCategoriesRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| List<string> | die Liste der Kategoriennamen (typischerweise mit höchstens einem Eintrag) |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindCategories(List<IFindCategoriesRequest>)
Liefert Listen von FindCategories-Ergebnismengen für alle übergebenen FindCategories-Anfragen. Dient zum Stellen mehrerer FindCategories-Anfragen mit einem API-Aufruf. Das Ergebnis ist eine Liste von Listen von Kategoriennamen.
Declaration
List<List<string>> FindCategories(List<IFindCategoriesRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IFindCategoriesRequest> | requests | die Requests - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<List<string>> | Liste von Listen von Kategoriennamen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen, wenn ein anderer Fehler aufgetreten ist |
FindCertificateByFingerprint(IFindCertificateByFingerprintRequest)
Ermittelt die Zertifikatsmetadaten des Zertifikats mit dem angegebenen Fingerprint, falls es mindestens einmal in der Datenbank hinterlegt ist.
Declaration
Certificate FindCertificateByFingerprint(IFindCertificateByFingerprintRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindCertificateByFingerprintRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| Certificate | Informationen aus den Binärdaten des angegebenen X.509 - Zertifikats |
Exceptions
| Type | Condition |
|---|---|
| DVDVNoHitsException | wird geworfen, wenn eine Anfrage gestellt wurde, die keine Treffer liefert |
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindOrganizationDescription(IFindOrganizationDescriptionRequest)
Liefert die eindeutige Organisation mit der angegebenen Kategorie und dem angegebenen Organisationsschlüssel. Entspricht in etwa der DVDV1-Methode
DVDVManager.processRequest
mit einem Parameter von TypFindAuthorityDescriptionRequest.
Declaration
OrganizationDescription FindOrganizationDescription(IFindOrganizationDescriptionRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindOrganizationDescriptionRequest | request | der Request |
Returns
| Type | Description |
|---|---|
| OrganizationDescription | die abgerufene Organisation |
Exceptions
| Type | Condition |
|---|---|
| DVDVNoHitsException | wird geworfen, wenn eine Anfrage gestellt wurde, die keine Treffer liefert |
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindOrganizationDescription(List<IFindOrganizationDescriptionRequest>)
Liefert die eindeutigen Organisationen mit den angegebenen Kategorien und den angegebenen Organisationsschlüsseln. Zurückgegeben werden zudem die Dienste, die der Organisation zugeordnet sind. Abweichend zu
FindServiceDescription
werden hierbei auch ungültige Dienste berücksichtigt. Im Unterschied zu der Methode FindOrganizationDescription zum Abruf
einer Organisation, wird hier keine DVDVNoHitsException geworfen, wenn eine oder mehrere der Anfragen keine Treffer liefern.
Dient zum Aubruf mehrerer Organisationen mit einem API-Aufruf.
Entspricht in etwa der DVDV1-Methode DVDVManager.processRequest
mit einem Parameter von TypFindAuthorityDescriptionRequest.
Declaration
List<OrganizationDescription> FindOrganizationDescription(List<IFindOrganizationDescriptionRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IFindOrganizationDescriptionRequest> | requests | die Requests - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<OrganizationDescription> | die abgerufenen Organisationen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen, wenn ein anderer Fehler aufgetreten ist |
FindOrganizationDescriptions(IFindOrganizationDescriptionsRequest)
Ähnlich wie FindOrganizationDescription, aber ohne Angabe der Kategorie. Liefert die Organisationen, die den angegebenen Organisationsschlüssel haben. Das ist fast immer höchstens eine.
Declaration
List<OrganizationDescription> FindOrganizationDescriptions(IFindOrganizationDescriptionsRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindOrganizationDescriptionsRequest | request | der Request |
Returns
| Type | Description |
|---|---|
| List<OrganizationDescription> |
FindOrganizationsByServiceElement(IFindOrganizationsByServiceElementRequest)
Liefert eine Liste von Organisationen, die mindestens einen Dienst anbieten, der mit einem bestimmten Dienstelement verknüpft ist. Das Dienstelement kann dabei spezifiziert werden über die Angabe eines Zertifikats oder der URI. Damit können Fragen geklärt werden wie:
- Gib mir alle Organisationen, die einen Dienst anbieten, der den Intermediär mit der URI 'http://.../intermediary' nutzt.
- Gib mir alle Organisationen, die einen Dienst anbieten, der ein Signaturzertifikat mit dem Fingerprint '584dd07...' nutzt.
Declaration
List<Organization> FindOrganizationsByServiceElement(IFindOrganizationsByServiceElementRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindOrganizationsByServiceElementRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| List<Organization> | die Liste von Organisationen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindOrganizationsByServiceElement(List<IFindOrganizationsByServiceElementRequest>)
Liefert Listen von FindOrganizationsByServiceElement-Ergebnismengen für alle übergebenen FindOrganizationsByServiceElement-Anfragen. Dient zum Stellen mehrerer FindOrganizationsByServiceElement-Anfragen mit einem API-Aufruf. Das Ergebnis ist eine Liste von Listen von Organisationen.
Declaration
List<List<Organization>> FindOrganizationsByServiceElement(List<IFindOrganizationsByServiceElementRequest> request)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IFindOrganizationsByServiceElementRequest> | request | die Requests |
Returns
| Type | Description |
|---|---|
| List<List<Organization>> | die Liste von Listen von Organisationen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindServiceDescription(IFindServiceDescriptionRequest)
Liefert die eindeutige, gültige Dienstbeschreibung der angegebenen Organisation mit der angegebenen Dienstbeschreibungs-URI. Dabei werden ausschließlich aktuell gültige Dienste berücksichtigt. Gültig ist ein Dienst, wenn die Serverzeit zum Zeitpunkt der Abfrage in dem für den Dienst hinterlegten Gültigkeitszeitraum liegt. Entspricht in etwa der DVDV1-Methode
DVDVManager.processRequest
mit einem Parameter von Typ IFindServiceDescriptionRequest.
Declaration
ServiceDescription FindServiceDescription(IFindServiceDescriptionRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IFindServiceDescriptionRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| ServiceDescription | die abgerufene Dienstbeschreibung |
Exceptions
| Type | Condition |
|---|---|
| DVDVNoHitsException | wird geworfen, wenn eine Anfrage gestellt wurde, die keine Treffer liefert |
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindServiceDescription(List<IFindServiceDescriptionRequest>)
Liefert die eindeutigen, gültigen Dienstbeschreibungen der angegebenen Organisationen mit den angegebenen Dienstbeschreibungs-URIs. Dient zum Aubruf mehrerer Dienstbeschreibungen mit einem API-Aufruf. Im Unterschied zu der Methode FindServiceDescription zum Abruf einer Dienstbeschreibung, wird hier keine DVDVNoHitsException geworfen, wenn eine oder mehrere der Anfragen keine Treffer liefern. Entspricht in etwa der DVDV1-Methode
DVDVManager.processRequest
mit einem Parameter von Typ IFindServiceDescriptionRequest.
Declaration
List<ServiceDescription> FindServiceDescription(List<IFindServiceDescriptionRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IFindServiceDescriptionRequest> | requests | die Requests - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<ServiceDescription> | die abgerufenen Dienstbeschreibungen |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen, wenn ein anderer Fehler aufgetreten ist |
FindServiceSpecificationUrisByCategory(ICategoryRequest)
Liefert eine Liste aller Werte von ServiceDescription.ServiceSpecificationUri von solchen Dienstbeschreibungen, die eine Organisation anbieten darf, wenn sie die angegebene Kategorie hat.
Declaration
List<string> FindServiceSpecificationUrisByCategory(ICategoryRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| ICategoryRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| List<string> | Liste von passenden URIs |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
FindServiceSpecificationUrisByCategory(List<ICategoryRequest>)
Batch-Variante der gleichnamige Methode
Declaration
List<List<string>> FindServiceSpecificationUrisByCategory(List<ICategoryRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<ICategoryRequest> | requests | die Requests - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<List<string>> | Liste von Listen von passenden URIs |
GetCategories()
Liefert den Baum aller im DVDV verzeichneten Kategorien. Das DVDV-Datenmodell bis wenigstens inklusive DVDV 2.7.0 lässt eine maximale Tiefe von 4 zu. Im aktuellen Datenbestand(Feb. 2023) beträgt die maximale Tiefe 2.
Declaration
List<OrganizationCategory> GetCategories()
Returns
| Type | Description |
|---|---|
| List<OrganizationCategory> | top-level Knoten im Baum aller im DVDV verzeichneten Kategorien |
GetIntermediaries()
Ermittelt alle Intermediäre im DVDV.
Declaration
List<SummaryServiceElement> GetIntermediaries()
Returns
| Type | Description |
|---|---|
| List<SummaryServiceElement> | Liste aller Intermediäre |
GetVersionInfo()
Fragt beim DVDV2-Server Versionsinformationen ab.
Declaration
VersionInfo GetVersionInfo()
Returns
| Type | Description |
|---|---|
| VersionInfo | Versionsinformationen vom aktiven DVDV2-Server |
RemoveFailoverListener(IFailoverListener)
Das Gegenstueck zu AddFailoverListener(IFailoverListener).
Declaration
void RemoveFailoverListener(IFailoverListener listener)
Parameters
| Type | Name | Description |
|---|---|---|
| IFailoverListener | listener | den zu registrierenden Listener |
RemoveRemoteCertificateValidationCallback()
Declaration
[Obsolete("Diese Methode ist obsolet seit 2.16.0. Verwenden Sie stattdessen IDVDV2ServerConnectionParamsBuilderStandalone.RemoteCertificateValidationCallback mit dem Parameter null", true)]
void RemoveRemoteCertificateValidationCallback()
SetRemoteCertificateValidationCallback(RemoteCertificateValidationCallback)
Declaration
[Obsolete("Diese Methode ist obsolet seit 2.16.0. Verwenden Sie stattdessen IDVDV2ServerConnectionParamsBuilderStandalone.RemoteCertificateValidationCallback", true)]
void SetRemoteCertificateValidationCallback(RemoteCertificateValidationCallback callback)
Parameters
| Type | Name | Description |
|---|---|---|
| RemoteCertificateValidationCallback | callback |
VerifyCategory(IVerifyCategoryRequest)
Prüft, ob es für die übergebene Behördenkategorie ein passendes Client-Zertifikat gibt. Die Schnittstelle liefert zu einem gegebenen Zertifikat-Fingerprint und der zugeordneten Organisationskategorie ein Prüfergebnis
true oderfalse,
und zwartrue genau dann, wenn es eine Organisation mit der angegebenen Organisationskategorie gibt,
für die das übermittelte Zertifikat als Client-Zertifikat hinterlegt ist.
Das Ergebnis ist zurzeit eine Map, in der es genau einen Eintrag gibt.
Dieser hat als Schlüssel den speziellen String verifyCategory und als Wert der o.a. Boolean.
Entspricht in etwa der DVDV1-Methode DVDVManager.processRequest
mit einem Parameter von TypIVerifyCategoryRequest.
Declaration
Dictionary<string, bool> VerifyCategory(IVerifyCategoryRequest request)
Parameters
| Type | Name | Description |
|---|---|---|
| IVerifyCategoryRequest | request | den Request |
Returns
| Type | Description |
|---|---|
| Dictionary<string, bool> | das Prüfergebnis |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen wenn ein anderer Fehler aufgetreten ist |
VerifyCategory(List<IVerifyCategoryRequest>)
Prüft, ob es für die übergebenen Behördenkategorien passende Client-Zertifikate gibt. Dient zum Anfrage mehrerer Behördenkategorien mit einem API-Aufruf. Entspricht in etwa der DVDV1-Methode
processRequest
mit einem Parameter von TypVerifyCategoryRequest.
Declaration
List<Dictionary<string, bool>> VerifyCategory(List<IVerifyCategoryRequest> requests)
Parameters
| Type | Name | Description |
|---|---|---|
| List<IVerifyCategoryRequest> | requests | die Requests - standardmäßig darf diese Liste maximal 200 Einträge haben. |
Returns
| Type | Description |
|---|---|
| List<Dictionary<string, bool>> | die Prüfergebnisse |
Exceptions
| Type | Condition |
|---|---|
| DVDVHttpException | wird geworfen, wenn die Anfrage mit einem HTTP-Fehlercode beantwortet wurde |
| DVDVException | wird geworfen, wenn ein anderer Fehler aufgetreten ist |