DVDV-Bibliothek für .NET
  • API
  • Lizenz
Search Results for

    Show / Hide Table of Contents
    • Dvdv.Api.Events
      • EventType
      • IFailoverEvent
      • IFailoverListener
    • Dvdv.Api.Exception
      • DVDVAuthenticationException
      • DVDVCertificateRevokedException
      • DVDVConfigurationException
      • DVDVException
      • DVDVHttpException
      • DVDVIOException
      • DVDVIllegalArgumentException
      • DVDVNoHitsException
      • Rfc7807Problem
    • Dvdv.Api.Manager
      • AuthMode
      • IDVDV2Manager
      • IDVDV2ManagerFactory
      • IDVDV2ServerConnectionParams
      • IDVDV2ServerConnectionParamsBuilderIam
      • IDVDV2ServerConnectionParamsBuilderIntern
      • IDVDV2ServerConnectionParamsBuilderStandalone
      • SummaryServiceElement
    • Dvdv.Api.Message
      • DVDVRequest
      • ICategoryRequest
      • IFindCategoriesRequest
      • IFindCertificateByFingerprintRequest
      • IFindOrganizationDescriptionRequest
      • IFindOrganizationDescriptionsRequest
      • IFindOrganizationsByServiceElementRequest
      • IFindServiceDescriptionRequest
      • IVerifyCategoryRequest
    • Dvdv.Api.Object
      • Certificate
      • Organization
      • OrganizationCategory
      • OrganizationDescription
      • ServiceBase
      • ServiceDescription
      • ServiceElementInfo
      • ServiceElementParameterType
      • ServiceElementType
      • ServiceSpecificationType
      • VersionInfo
    • Dvdv.Impl.Broker.Dto
      • FailoverEvent
    • Dvdv.Impl.Broker.Dto.Request
      • CategoryBody
      • FindCategoriesBody
      • FindCertificateByFingerprintBody
      • FindOrganizationsByServiceElementBody
      • OrganizationDescriptionBody
      • ServiceDescriptionBody
      • ValidCategoryBody
    • Dvdv.Impl.Manager
      • DVDV2ManagerFactory

    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 Source

    AddFailoverListener(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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    X509Certificate2.Thumbprint
    string organizationKey

    den DVDV-Organisationsschlüssel

    Returns
    Type Description
    IFindCategoriesRequest

    passende Instanz für den Aufruf von findCategories

    | Edit this page View Source

    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

    X509Certificate2.Thumbprint
    Returns
    Type Description
    IFindCertificateByFingerprintRequest

    Frisches Objekt vom Typ IFindCertificateByFingerprintRequest

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    X509Certificate2.Thumbprint
    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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 Typ
    FindAuthorityDescriptionRequest
    .
    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

    | Edit this page View Source

    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 Typ
    FindAuthorityDescriptionRequest
    .
    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

    | Edit this page View Source

    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>
    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    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

    | Edit this page View Source

    GetIntermediaries()

    Ermittelt alle Intermediäre im DVDV.

    Declaration
    List<SummaryServiceElement> GetIntermediaries()
    Returns
    Type Description
    List<SummaryServiceElement>

    Liste aller Intermediäre

    | Edit this page View Source

    GetVersionInfo()

    Fragt beim DVDV2-Server Versionsinformationen ab.

    Declaration
    VersionInfo GetVersionInfo()
    Returns
    Type Description
    VersionInfo

    Versionsinformationen vom aktiven DVDV2-Server

    | Edit this page View Source

    RemoveFailoverListener(IFailoverListener)

    Das Gegenstueck zu AddFailoverListener(IFailoverListener).

    Declaration
    void RemoveFailoverListener(IFailoverListener listener)
    Parameters
    Type Name Description
    IFailoverListener listener

    den zu registrierenden Listener

    | Edit this page View Source

    RemoveRemoteCertificateValidationCallback()

    Declaration
    [Obsolete("Diese Methode ist obsolet seit 2.16.0. Verwenden Sie stattdessen IDVDV2ServerConnectionParamsBuilderStandalone.RemoteCertificateValidationCallback mit dem Parameter null", true)]
    void RemoveRemoteCertificateValidationCallback()
    | Edit this page View Source

    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
    | Edit this page View Source

    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
    oder
    false
    , und zwar
    true
    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 Typ
    IVerifyCategoryRequest
    .
    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

    | Edit this page View Source

    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 Typ
    VerifyCategoryRequest
    .
    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

    • Edit this page
    • View Source
    In this article
    Back to top Generated by DocFX