IMAP komendy to zbiorcze określenie poleceń tego protokołu wykorzystywanych do zarządzania wiadomościami na serwerze.
Jak działają komendy IMAP w połączeniu z serwerem pocztowym
Komendy IMAP są tekstowymi poleceniami wysyłanymi przez klienta pocztowego do serwera obsługującego skrzynkę. Protokół IMAP4rev1 opisano w RFC 3501, a nowszą wersję IMAP4rev2 w RFC 9051. Wymiana danych odbywa się według określonego schematu: klient wysyła komendę, serwer może zwrócić dane pośrednie, a następnie przekazuje oznaczoną odpowiedź końcową. Każda komenda klienta ma własny identyfikator, nazywany znacznikiem lub tagiem, na przykład A001. Przykładowe żądanie może mieć postać A001 CAPABILITY.
Komendy są dostępne w zależności od stanu połączenia. Po nawiązaniu sesji klient może wykonywać między innymi CAPABILITY, NOOP i LOGOUT. Przed uwierzytelnieniem stosuje się polecenia takie jak LOGIN, AUTHENTICATE albo STARTTLS, o ile serwer je obsługuje i pozwala na ich użycie. Po poprawnym uwierzytelnieniu można wybrać skrzynkę poleceniem SELECT lub otworzyć ją w trybie tylko do odczytu za pomocą EXAMINE. Dopiero stan wybranej skrzynki pozwala wykonywać operacje dotyczące konkretnych wiadomości.
Komendy do wyboru skrzynki, wyszukiwania i odczytu wiadomości
Polecenie LIST służy do pobrania informacji o dostępnych skrzynkach i folderach, natomiast STATUS pozwala odczytać wybrane dane o skrzynce bez wybierania jej jako aktywnej. Po użyciu SELECT INBOX klient może korzystać z poleceń dotyczących wiadomości znajdujących się w folderze INBOX. SEARCH wyszukuje wiadomości według kryteriów określonych przez protokół, takich jak nadawca, odbiorca, temat, data, obecność określonego tekstu albo ustawione flagi.
Do pobierania danych o wiadomościach służy FETCH. Klient może za jego pomocą pobrać między innymi nagłówki, temat, adresy nadawcy i odbiorcy, rozmiar wiadomości, strukturę MIME, treść albo wybrany fragment treści. Wariant BODY.PEEK pozwala odczytać zawartość bez automatycznego ustawiania flagi oznaczającej przeczytanie, podczas gdy pobranie treści w inny sposób może spowodować zmianę stanu wiadomości zgodnie z zasadami protokołu. STORE zmienia flagi, na przykład \Seen, \Flagged lub \Deleted, a COPY kopiuje wiadomości do innej skrzynki. W IMAP4rev2 dostępne jest również MOVE, które przenosi wiadomości między skrzynkami.
Numery wiadomości, UID i odpowiedzi serwera
IMAP posługuje się dwoma rodzajami identyfikatorów wiadomości. Numer sekwencyjny jest pozycją wiadomości w aktualnie wybranej skrzynce i może się zmienić po usunięciu lub odświeżeniu jej zawartości. UID, czyli unikatowy identyfikator wiadomości, jest przeznaczony do stabilniejszego śledzenia wiadomości przez klienta. Do operacji wykorzystujących UID służy prefiks UID, na przykład UID FETCH, UID SEARCH albo UID STORE. Klient powinien uwzględniać także wartość UIDVALIDITY, ponieważ zmiana tej wartości oznacza, że wcześniej zapisane UID-y nie mogą być bezwarunkowo traktowane jako aktualne.
Serwer zwraca odpowiedzi oznaczone między innymi jako OK, NO i BAD. OK oznacza pomyślne wykonanie komendy, NO sygnalizuje odrzucenie operacji, na przykład z powodu braku uprawnień lub niedostępnej skrzynki, a BAD wskazuje na nieprawidłową składnię albo nieznaną komendę. Oprócz odpowiedzi końcowej serwer może wysyłać nieoznaczone odpowiedzi zawierające liczbę wiadomości, dostępne flagi lub dane zwrócone przez FETCH. Flaga \Deleted nie zawsze oznacza natychmiastowe fizyczne usunięcie wiadomości. Trwałe usunięcie następuje po wykonaniu EXPUNGE, dlatego błędna kolejność poleceń może prowadzić do niezamierzonych zmian w skrzynce.
Komendy IMAP w diagnostyce klienta pocztowego
Nieprawidłowe działanie programu pocztowego można powiązać z konkretnym etapem obsługi komend IMAP. Brak listy folderów może wskazywać na problem z LIST lub przestrzenią nazw skrzynki. Widoczność folderu bez wiadomości może wiązać się z błędnym użyciem SELECT, opóźnieniem synchronizacji albo ograniczeniem zakresu danych pobieranych przez FETCH. Z kolei wiadomości pozostające jako nieprzeczytane mogą wynikać z użycia BODY.PEEK albo nieudanego polecenia STORE zmieniającego flagę \Seen.
Podczas sprawdzania konfiguracji należy rozróżnić problem z połączeniem, uwierzytelnieniem, wyborem skrzynki i pobieraniem treści. Przydatne są zapisy sesji pokazujące tag komendy oraz odpowiadający mu wynik, ponieważ sam komunikat programu pocztowego często nie wskazuje, które polecenie zostało odrzucone. Trzeba także odróżnić IMAP od SMTP: IMAP służy do dostępu do wiadomości przechowywanych na serwerze, natomiast wysyłanie poczty realizuje protokół składania wiadomości, zwykle SMTP Submission. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów PC, w tym diagnostykę problemów z konfiguracją i działaniem klienta pocztowego.
