Package de.dvdv2.manager

Interface DVDV2ServerConnectionParamsBuilderIam<B extends DVDV2ServerConnectionParamsBuilderIam<?>>

public interface DVDV2ServerConnectionParamsBuilderIam<B extends DVDV2ServerConnectionParamsBuilderIam<?>>
Builder zum Erzeugen von DVDV2ServerConnectionParams-Instanzen zur Parametrisierung einer IAM/Keycloak-authentifizierten Verbindung zum DVDV-Server.

  • Method Details

    • withBaseUrl

      B withBaseUrl(URL baseUrl)
      Einstiegs-URL zum DVDV2-Kernsystem, muss mit slash ('/') enden.
      Parameters:
      baseUrl - http- oder https-URL
      Returns:
      this

    • withHttpClientBuilder

      B withHttpClientBuilder(okhttp3.OkHttpClient.Builder httpClientBuilder)
      Setzt der OkHttp3-Client-Builder, den der DVDVManager zum Verbindungsaufbau zu dem betreffenden DVDV2-Server und zum IAM/Keycloak-Server nutzen soll.
      Sie sollten wenigstens httpClientBuilder.connectTimeout(...) und httpClientBuilder.readTimeout(...) aufrufen.
      Returns:
      this

    • withIamBaseUrl

      B withIamBaseUrl(URL iamBaseUrl) throws DVDVConfigurationException
      Einstiegs-URL zum IAM/Keycloak.
      Parameters:
      iamBaseUrl - http- oder https-URL
      Returns:
      this
      Throws:
      DVDVConfigurationException

    • withClientId

      B withClientId(String clientId)
      Die IAM/Keycloak-basierte Authentifizierung nutzt die angegebene "client id" und die folgenden Parameter:
      • client assertion type: "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
      • grant type: "client_credentials"
      Parameters:
      clientId - in Ihrem IAM/Keycloak adminstrierte "client id"
      Returns:
      this

    • withTokenTimeoutSecs

      B withTokenTimeoutSecs(int timeoutSecs)
      Lebensdauer des Tokens (in Sekunden). Default: 10.
      Returns:
      this

    • withCertificateAndPrivateKey

      B withCertificateAndPrivateKey(CertificateAndPrivateKey certificateAndPrivateKey)
      Zertifikat und zugehöriger privater Schlüssel für die Authentifizierung am IAM/Keycloak oder standalone.
      Returns:
      this

    • withCertificateAndPrivateKeyAfterChange

      B withCertificateAndPrivateKeyAfterChange(Date approxChange, CertificateAndPrivateKey certificateAndPrivateKey)
      wie withCertificateAndPrivateKey(CertificateAndPrivateKey), aber mit voraussichtlichem Zertifikatswechseltermin
      Parameters:
      approxChange - voraussichtlicher Zertifikatswechseltermin. Legt fest, ab wann die mit dieser Methode angegebenen Credentials gegenüber denjenigen aus withCertificateAndPrivateKey(de.dvdv2.manager.CertificateAndPrivateKey) zu bevorzugen sind.
      Returns:
      this

    • build

      DVDV2ServerConnectionParams build() throws DVDVConfigurationException
      Erzeugt ein Objekt von Typ DVDV2ServerConnectionParams mit den in diesem Builder angegebenen Parametern. Hiermit findet die Verbindung zum DVDV2-Server findet statt mit Verwendung des IAM/Keycloak.
      Throws:
      DVDVConfigurationException