1SASL-XOAUTH2-TOOL(1)        Generated Python Manual       SASL-XOAUTH2-TOOL(1)
2
3
4

NAME

6       sasl-xoauth2-tool
7

SYNOPSIS

9       sasl-xoauth2-tool [-h] {get-token,test-config,test-token-refresh} ...
10
11

POSITIONAL ARGUMENTS

COMMAND 'sasl-xoauth2-tool get-token'

14       usage: sasl-xoauth2-tool get-token [-h] --client-id CLIENT_ID
15                                          [--tenant TENANT]
16                                          [--client-secret CLIENT_SECRET]
17                                          [--scope SCOPE] [--use-device-flow]
18                                          {outlook,gmail} [output_file]
19
20       Fetches initial access and refresh tokens from an OAuth 2 provider
21
22
23       {outlook,gmail}
24              service type
25
26
27       output_file
28              output file, '-' for stdout
29
30

OPTIONS 'sasl-xoauth2-tool get-token'

32       --client-id CLIENT_ID
33              required for both services
34
35
36       --tenant TENANT
37              wanted by 'outlook' (defaults to 'consumers')
38
39
40       --client-secret CLIENT_SECRET
41              required for both services, will prompt the user if blank
42
43
44       --scope SCOPE
45              required for 'gmail'
46
47
48       --use-device-flow
49              use simplified device flow for Outlook/Azure
50
51

COMMAND 'sasl-xoauth2-tool test-config'

53       usage: sasl-xoauth2-tool test-config [-h] [--config-file CONFIG_FILE]
54
55       Tests a sasl-xoauth2 config file for syntax errors
56
57

OPTIONS 'sasl-xoauth2-tool test-config'

59       --config-file CONFIG_FILE
60              config file path (defaults to '/etc/sasl-xoauth2.conf')
61
62

COMMAND 'sasl-xoauth2-tool test-token-refresh'

64       usage:  sasl-xoauth2-tool  test-token-refresh  [-h] [--config-file CON‐
65       FIG_FILE]
66                                                   token_file
67
68       Tests that a token can be refreshed (i.e., that the  OAuth  2  flow  is
69       working correctly)
70
71
72       token_file
73              file containing initial access token
74
75

OPTIONS 'sasl-xoauth2-tool test-token-refresh'

77       --config-file CONFIG_FILE
78              config file path (defaults to '/etc/sasl-xoauth2.conf')
79
80

AUTHOR

82       Tarick Bedeir
83       tarick@bedeir.com
84
85

DISTRIBUTION

87       The   latest   version   of   sasl-xoauth2   may   be  downloaded  from
88       ⟨https://github.com/tarickb/sasl-xoauth2⟩
89
90
91
92sasl-xoauth2                      2023-08-07              SASL-XOAUTH2-TOOL(1)