Skip to main content

gRPC Schnittstelle

gRPC API documents5 und die Abhängigkeit zu maildaemon​

Es ist wichtig, dass der gRPC-Dienst des documents5-Servers läuft.

Bitte beachten Sie die offizielle Dokumentation von otris hier

info

Zum Start von Maildaemon wird geprüft, ob die gRPC Zertifikate gültig sind. Falls ein Zertifikat innerhalb von einem Jahr abläuft wird hierzu eine Warnung ausgegeben. Falls das Zertifikat abgelaufen ist wird ein Fehler geworfen.

Nach dem Aktivieren und Erstellen der benötigten Zertifikate stellen Sie sicher, dass Sie:

  1. den gRPC-Dienst in der Datei documents.ini aktiviert haben.
  2. ein Server-Zertifikat erstellt haben
  3. ein Client-Zertifikat erstellen (z.B. maildaemon nennen, dann heißen die erzeugten Dateien normalerweise maildaemon_cert.pem und maildaemon_key.pem)
  4. Starten Sie den document5-Server neu
  5. Aktualisierung der Mailbox-Konfigurationsdatei mit den vollständigen Pfaden zu den oberen Dateien.

Häufige Fehler bei der Ausführung von maildaemon​

Cannot connect to grpc server and create session​

Cannot connect to grpc server and create session: Error starting gRPC call. HttpRequestException: Could not connect because the target computer refused to connect.

(localhost:50050) SocketException: Could not connect because the target computer refused to connect.

Dieser Fehler besagt in der Regel, dass sich die Bibliothek nicht mit dem gRPC-Dienst von documents5 verbinden kann.

Mögliche Gründe sind:

  • Der gRPC-Dienst ist nicht aktiviert (haben Sie den documents5-Server neu gestartet, nachdem Sie die documents.ini aktualisiert haben?)
  • Die Server- oder Client-Zertifikate fehlen, haben Sie sie erstellt?

Could not createDocFile​

[ERR] Could not createDocFile for message xxxx
...
[FTL] Could not process message on mailbox with MailID: xxxx | Subject: xxxx reason: Could not create file: filetype does not exist.
  • Vergewissern Sie sich, dass Sie Ihre Mailboxkonfiguration richtig konfiguriert haben, der Fehler weist auf den falschen Dateityp hin.

Debug-Option insecure override für gRPC Verbindung​

Es gibt eine Debug-Option namens "insecure" in den gRPC-Einstellungen, welche die Zertifikatsvalidierung umgeht und den Server über HTTP anstatt HTTPS anspricht.

Diese Funktion kann aktiviert werden, indem die Variable "MAILDAEMON_GRPC_INSECURE" in den Systemumgebungsvariablen gesetzt wird.

Typisierungen

Wichtig: zusätzlich muss in der documents.ini die Einstellung $GRPCInsecure=localhost gesetzt werden.