.TH sasl-xoauth2-tool "1" Manual
.SH NAME
sasl-xoauth2-tool
.SH SYNOPSIS
.B sasl-xoauth2-tool
[-h] {get-token,test-config,test-token-refresh} ...
.SH OPTIONS
.SS
\fBSub-commands\fR
.SH OPTIONS 'sasl-xoauth2-tool get-token'
usage: sasl-xoauth2-tool get-token [-h] --client-id CLIENT_ID
                                   [--tenant TENANT]
                                   [--client-secret CLIENT_SECRET]
                                   [--scope SCOPE]
                                   {outlook,gmail} [output_file]

Fetches initial access and refresh tokens from an OAuth 2 provider

.TP
\fB{outlook,gmail}\fR
service type

.TP
\fBoutput_file\fR
output file, '\-' for stdout

.TP
\fB\-\-client\-id\fR \fI\,CLIENT_ID\/\fR
required for both services

.TP
\fB\-\-tenant\fR \fI\,TENANT\/\fR
wanted by 'outlook' (defaults to 'consumers')

.TP
\fB\-\-client\-secret\fR \fI\,CLIENT_SECRET\/\fR
required for both services, will prompt the user if blank

.TP
\fB\-\-scope\fR \fI\,SCOPE\/\fR
required for 'gmail'

.SH OPTIONS 'sasl-xoauth2-tool test-config'
usage: sasl-xoauth2-tool test-config [-h] [--config-file CONFIG_FILE]

Tests a sasl\-xoauth2 config file for syntax errors


.TP
\fB\-\-config\-file\fR \fI\,CONFIG_FILE\/\fR
config file path (defaults to '/etc/sasl\-xoauth2.conf')

.SH OPTIONS 'sasl-xoauth2-tool test-token-refresh'
usage: sasl-xoauth2-tool test-token-refresh [-h] [--config-file CONFIG_FILE]
                                            token_file

Tests that a token can be refreshed (i.e., that the OAuth 2 flow is working correctly)

.TP
\fBtoken_file\fR
file containing initial access token

.TP
\fB\-\-config\-file\fR \fI\,CONFIG_FILE\/\fR
config file path (defaults to '/etc/sasl\-xoauth2.conf')

.SH AUTHORS
.B sasl\-xoauth2
was written by Tarick Bedeir <tarick@bedeir.com>.
.SH DISTRIBUTION
The latest version of sasl\-xoauth2 may be downloaded from
.UR https://github.com/tarickb/sasl\-xoauth2
.UE