Sample code for 30+ languages & platforms
CkPerl Requires Chilkat v11.0.0+

Gmail: Authenticate with an App Password

See more GMail SMTP/IMAP/POP Examples

Authenticate to Gmail IMAP, SMTP, or POP3 with a Google app password. Choose one protocol in the code; the example authenticates and disconnects without sending, retrieving, or deleting messages.

OAuth2 is the recommended approach. An app password is an account-specific 16-character password generated under Google Account security settings after enabling 2-Step Verification. Use the generated value without display spaces, not your normal Google password. App passwords may be unavailable under Advanced Protection, security-key-only 2-Step Verification, or organization policy. Changing the Google account password revokes its app passwords.

Store the app password in protected configuration and load it at runtime. It is a credential, not an OAuth token, so this example uses the protocol password property and does not set OAuth2AccessToken. There is no supported instruction to enable “less secure apps.” POP must be enabled in Gmail settings; Workspace administrators can also restrict IMAP and POP. Personal Gmail IMAP is always enabled.

Google documentation

Chilkat CkPerl Downloads

CkPerl
use chilkat();

$success = 0;

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

#  Choose "imap", "smtp", or "pop". This example only tests authentication.
$protocol = "imap";
$mailbox = 'user@example.com';
#  Replace this placeholder with a value loaded from protected configuration.
$appPassword = "YOUR_16_CHARACTER_APP_PASSWORD";
if ($protocol == "imap") {
    $imap = chilkat::CkImap->new();
    $imap->put_Ssl(1);
    $imap->put_Port(993);
    $imap->put_RequireSslCertVerify(1);
    $success = $imap->Connect("imap.gmail.com");
    if ($success != 1) {
        print "Could not establish the Gmail IMAP TLS connection." . "\r\n";
        exit;
    }

    $success = $imap->Login($mailbox,$appPassword);
    if ($success != 1) {
        $imap->Disconnect();
        print "IMAP authentication failed. Check the app password and account policy." . "\r\n";
        exit;
    }

    $imap->Logout();
    $imap->Disconnect();
}
else {
    $mailman = chilkat::CkMailMan->new();
    $mailman->put_RequireSslCertVerify(1);
    if ($protocol == "smtp") {
        $mailman->put_SmtpHost("smtp.gmail.com");
        $mailman->put_SmtpPort(465);
        $mailman->put_SmtpSsl(1);
        $mailman->put_StartTLS(0);
        $mailman->put_SmtpUsername($mailbox);
        $mailman->put_SmtpPassword($appPassword);
        $success = $mailman->SmtpConnect();
        if ($success != 1) {
            print "Could not establish the Gmail SMTP TLS connection." . "\r\n";
            exit;
        }

        $success = $mailman->SmtpAuthenticate();
        $mailman->CloseSmtpConnection();
        if ($success != 1) {
            print "SMTP authentication failed. Check the app password and account policy." . "\r\n";
            exit;
        }

    }
    else {
        if ($protocol != "pop") {
            print "Choose imap, smtp, or pop." . "\r\n";
            exit;
        }

        $mailman->put_MailHost("pop.gmail.com");
        $mailman->put_MailPort(995);
        $mailman->put_PopSsl(1);
        $mailman->put_PopUsername($mailbox);
        $mailman->put_PopPassword($appPassword);
        $success = $mailman->Pop3Connect();
        if ($success != 1) {
            print "Could not establish the Gmail POP3 TLS connection." . "\r\n";
            exit;
        }

        $success = $mailman->Pop3Authenticate();
        #  Disconnect without QUIT; this authentication test makes no mailbox changes.
        $mailman->Pop3EndSessionNoQuit();
        if ($success != 1) {
            print "POP3 authentication failed. Check the app password, POP setting, and account policy." . "\r\n";
            exit;
        }

    }

}

print "Gmail authentication succeeded using " . $protocol . "\r\n";