This page in English

Wenn Mails scheitern ​

Ein falsches Passwort, ein Tippfehler im Servernamen, ein Anbieter, der Programme sperrt: Ein Mailprogramm trifft auf mehr Ärger als die meisten. Dieses Rezept sendet eine Testmail und sagt dem Spieler, wenn es nicht klappt, in einfachen Worten, was zu reparieren ist – das Programm, das du zuerst probierst, wenn du Mails einrichtest.

Funktionen: die Fehler von c0de net, SMTP_SEND, IMAP_CREATE und HAS_SECRET aus c0de/security

Was du brauchst

Die Mod c0de net, dein Mailkonto und dein App-Passwort wie in Mail von der Farm, einen Auslöserblock mit Knopf, einen Laptop und Variablenkarten server (STRING) und port (INTEGER). Für die Übung den IMAP-Server aus Der Bestellschalter.

Die Idee ​

Die Funktionen von c0de_net/mail lösen einen Fehler aus, wenn etwas schiefgeht. Ein CALL mit einer ERROR-Variablen fängt ihn ab, und ihr code sagt, was passiert ist:

CodeNameWas passiert istWas zu tun ist
309INVALID_ARGUMENTkein Server oder Absender, eine Adresse, die keine ist, unbekannte Kriterienkorrigiere das Programm
311PERMISSION_DENIEDeine Verbindung zu Port 25nimm Port 465 oder 587 deines Anbieters
1001CLIENT_UNAVAILABLEder Spieler ist nicht online oder hat kein c0de netnichts, später nochmal
1003REQUEST_FAILEDkeine Verbindung: unbekannter Server, abgewiesen, ein Zertifikatsproblemprüfe Server, Port und security
1004REQUEST_TIMEOUTder Server hat nicht rechtzeitig geantwortetspäter nochmal
1005RESPONSE_TOO_LARGEIMAP_FETCH würde zu viel lesenweniger Nachrichten holen, oder ohne Text
1006MAIL_DISABLEDder Server oder der Spieler hat Mails abgeschaltetfrag den Administrator, oder allowMail=true
1007AUTHENTICATION_FAILEDBenutzername oder Passwort ist falschnimm ein App-Passwort
1008MAIL_REJECTEDder Mailserver hat abgelehnt, etwa einen Empfänger oder einen Ordnerlies die Meldung des Fehlers
1009MAIL_LIMITzu viele Empfänger, zu viel Text, zu viele Mails pro Minuteweniger senden, oder eine Minute warten

INVALID_ARGUMENT und PERMISSION_DENIED sind Konstanten von c0de; die anderen kommen mit INCLUDE c0de_net/mail, als c0de_net/mail/AUTHENTICATION_FAILED und so weiter.

Die meisten Probleme eines neuen Mailprogramms sind AUTHENTICATION_FAILED: Viele Anbieter lassen Programme nicht mit dem Passwort des Kontos herein. Leg in den Sicherheitseinstellungen deines Kontos ein App-Passwort für c0de an und nimm dieses.

Das Programm ​

c0de
PROGRAM mailcheck
NOOP
INCLUDE c0de/security
INCLUDE c0de/strings
INCLUDE c0de_net/mail
NOOP
FUNCTION explain
    PARAMETER code INTEGER
    RESULT text STRING
BEGIN
    ASSIGN text "Unexpected error " ⊕ code ;
    IF code = INVALID_ARGUMENT ;
    BEGIN
        ASSIGN text "Check the server, the sender and the addresses" ;
    END IF
    IF code = PERMISSION_DENIED ;
    BEGIN
        ASSIGN text "Port 25 is blocked, use 465 or 587" ;
    END IF
    IF code = c0de_net/mail/CLIENT_UNAVAILABLE ;
    BEGIN
        ASSIGN text "Nobody with c0de net is online" ;
    END IF
    IF code = c0de_net/mail/MAIL_DISABLED ;
    BEGIN
        ASSIGN text "Mail is switched off" ;
    END IF
    IF code = c0de_net/mail/AUTHENTICATION_FAILED ;
    BEGIN
        ASSIGN text "Wrong user or password (an app password?)" ;
    END IF
    IF code = c0de_net/mail/MAIL_REJECTED ;
    BEGIN
        ASSIGN text "The mail server refused it" ;
    END IF
    IF code = c0de_net/mail/MAIL_LIMIT ;
    BEGIN
        ASSIGN text "Too much mail: send less or wait a minute" ;
    END IF
    IF code = c0de_net/mail/REQUEST_FAILED ;
    BEGIN
        ASSIGN text "The mail server can't be reached" ;
    END IF
    IF code = c0de_net/mail/REQUEST_TIMEOUT ;
    BEGIN
        ASSIGN text "The mail server is too slow" ;
    END IF
END FUNCTION
NOOP
FUNCTION account
    PARAMETER server STRING
    PARAMETER port INTEGER
    RESULT smtp STRUCT c0de_net/mail/SMTP_SERVER
BEGIN
    SECRET mailPassword STRING
    ASSIGN smtp.server server ;
    ASSIGN smtp.port port ;
    ASSIGN smtp.security "tls" ;
    ASSIGN smtp.user "steve@example.com" ;
    ASSIGN smtp.password mailPassword ;
    ASSIGN smtp.from "Farm computer <steve@example.com>" ;
    ASSIGN smtp.timeout 10 ;
END FUNCTION
NOOP
FUNCTION send
    PARAMETER server STRING "smtp.example.com"
    PARAMETER port INTEGER 0
    PARAMETER to STRING "steve@example.com"
    PARAMETER lines INTEGER 3
BEGIN
    VARIABLE known BOOLEAN
    VARIABLE smtp STRUCT c0de_net/mail/SMTP_SERVER
    VARIABLE problem ERROR
    VARIABLE text STRING
    VARIABLE message STRING
    VARIABLE nl CHAR
    CALL CLS
    CALL c0de/security/HAS_SECRET
        PARAMETER name "mailPassword" ;
        RESULT result known
    IF NOT known ;
    BEGIN
        CALL PRINT
            PARAMETER value "Put your password into the vault first" ;
        EXIT 2 ;
    END IF
    CALL account
        PARAMETER server server ;
        PARAMETER port port ;
        RESULT smtp smtp
    CALL c0de/strings/CHR
        PARAMETER code 10 ;
        RESULT result nl
    FOR i INTEGER 1 ; lines ;
    BEGIN
        ASSIGN text text ⊕ "Line " ⊕ i ⊕ ": the farm is fine." ⊕ nl ;
    END FOR
    CALL c0de_net/mail/SMTP_SEND problem
        PARAMETER server smtp ;
        PARAMETER to to ;
        PARAMETER subject "A test from the farm" ;
        PARAMETER text text ;
    IF problem.code ≠ 0 ;
    BEGIN
        CALL explain
            PARAMETER code problem.code ;
            RESULT text message
        CALL PRINT
            PARAMETER value message ;
        EXIT 1 ;
    END IF
    CALL PRINT
        PARAMETER value "Sent to " ⊕ to ;
END FUNCTION

Aufbauen und ausführen ​

  1. Stelle den Auslöserblock auf mailcheck / send, leg deine Variablenkarten server und port hinein und binde den Laptop daran.
  2. Drück den Knopf. Wenn alles stimmt, zeigt der Laptop Sent to steve@example.com – nimm deine eigene Adresse für to – und eine Testmail kommt an.
  3. Mach es jetzt absichtlich kaputt, immer nur eine Sache, und schau auf den Laptop:
Du änderstDer Laptop zeigtExit-Code
der Tresor ist leer oder geschlossenPut your password into the vault first2
ein falsches Passwort im TresorWrong user or password (an app password?)1
server auf smtp.nothing.invalidThe mail server can't be reached1
port auf 25Port 25 is blocked, use 465 or 5871
to auf nobodyCheck the server, the sender and the addresses1
lines auf 3000Too much mail: send less or wait a minute1
the laptop showing "Wrong user or password (an app password?)" next to the trigger block of mailcheck

So funktioniert es ​

  • explain macht aus einem Code Worte, wie in Wenn das Netz ausfällt: Es beginnt mit einer Meldung für unbekannte Codes und überschreibt sie für jeden Code, den es kennt.
  • HAS_SECRET fragt zuerst den Tresor. Eine SECRET-Zeile für ein fehlendes Geheimnis löst SECRET_NOT_FOUND aus und hält das Programm an, deshalb ruft send die Funktion account mit der SECRET-Zeile nur auf, wenn das Passwort da ist. Ohne offenen Tresor sagt HAS_SECRET ebenfalls FALSE.
  • account gibt den SMTP_SERVER als Ergebnis zurück, sodass das Passwort nur darin und im Struct lebt. Sein timeout von 10 Sekunden lässt einen Test schnell scheitern, statt die vollen 30 zu warten.
  • Die FOR-Schleife schreibt lines Zeilen Text. 3000 Zeilen sind etwa 90 KiB, mehr als die 64 KiB, die eine Nachricht haben darf: SMTP_SEND löst MAIL_LIMIT aus, bevor es sich verbindet. Zu viele Empfänger oder mehr als 10 Mails pro Minute lösen ihn ebenso aus.
  • Die Exit-Codes sind 0 für gesendet, 1 für einen Fehler der Mail und 2 für ein fehlendes Passwort, sodass ein Komparator neben dem Auslöserblock sie anzeigen kann.

Anders als in Wenn das Netz ausfällt gibt es keine Wiederholung: Die meisten Mailfehler gehen nicht von selbst weg, und eine Wiederholung eines SMTP_SEND, das in den Timeout lief, könnte die Nachricht zweimal senden.

Probier es selbst ​

  1. Das Ordnerprogramm eines Freundes stürzt ab, wenn der Ordner schon existiert. Fang das ab.
Lösung
c0de
PROGRAM newfolder
NOOP
INCLUDE c0de_net/mail
NOOP
FUNCTION create
    PARAMETER server STRING "imap.example.com"
    PARAMETER port INTEGER 0
    PARAMETER name STRING "Orders"
BEGIN
    SECRET mailPassword STRING
    VARIABLE imap STRUCT c0de_net/mail/IMAP_SERVER
    VARIABLE problem ERROR
    ASSIGN imap.server server ;
    ASSIGN imap.port port ;
    ASSIGN imap.user "steve@example.com" ;
    ASSIGN imap.password mailPassword ;
    CALL CLS
    CALL c0de_net/mail/IMAP_CREATE problem
        PARAMETER server imap ;
        PARAMETER folder name ;
    IF problem.code = c0de_net/mail/MAIL_REJECTED ;
    BEGIN
        CALL PRINT
            PARAMETER value "The server refused: " ⊕ name ⊕ " exists already?" ;
        EXIT 1 ;
    END IF
    IF problem.code ≠ 0 ;
    BEGIN
        CALL PRINT
            PARAMETER value problem.message ;
        EXIT 2 ;
    END IF
    CALL PRINT
        PARAMETER value "Created " ⊕ name ;
END FUNCTION

IMAP_CREATE löst für einen Ordner, den es schon gibt, MAIL_REJECTED aus – der Mailserver lehnt den Befehl ab. Das Programm sagt das und endet mit Exit-Code 1. Mit dem Namen Invoices zeigt es Created Invoices. Jeder andere Fehler endet mit seiner Meldung und Exit-Code 2.

  1. Alex hat im eigenen Spiel allowMail=false gesetzt. Was passiert, wenn Alex den Knopf drückt? Und was, wenn ein Zeitgeberblock das Programm an einem Auslöserblock startet, der Alex gehört?
Lösung

Beide Male zeigt der Laptop Mail is switched off: MAIL_DISABLED. Die Mail ginge von Alex' Computer hinaus – wenn Alex den Knopf drückt, weil Alex den Prozess gestartet hat, und beim Zeitgeberblock, weil ein Prozess, den niemand gestartet hat, als Besitzer des Auslöserblocks läuft. Drückt Steve den Knopf, geht die Mail von Steves Computer hinaus und klappt. Ein Administrator, der enableMail=false in config/c0de_net.properties setzt, schaltet Mails für alle ab.

Mehr dazu ​