|tdoauth(1)||FreeBSD General Commands Manual||tdoauth(1)|
tdoauthis used to request and store OAuth authorization credentials for services that require them, such as Google Calendar.
To use a calendar on a service that requires OAuth, several steps are necessary.
TDcal is an
open-source application, it is unclear if service provider client
credentials can be distributed by the developer as doing so would allow them
to easily be copied and mis-used in other applications. Furthermore, the
developer is not interested in creating and maintaining application client
accounts with each online calendar provider that requires the use of OAuth.
So, the pleasure of doing this is left to you, the user.
First, you must register
TDcal as a client
application and obtain OAuth client credentials on your service provider's
account. To register a client application, you will need to follow the
instructions at your service provider. These often involve finding the
developer console, creating a project for
registering it as an application that wishes to access private calendar data
stored in your account and requesting client credentials for the
application. You will need the following information:
If you register
TDcal as an application
for your own use, or for the use of yourself and a few others known to you,
you do not need to publish your application registration for public use and
you therefore do not need to go through the app verification process.
You will be given a
client_secret’ which you can
configure in your
TDcal configuration file, see
Next configure the calendar as shown in the example in td(5).
tdoauth. The arguments are the
name of the calendar as configured and the name of the service. Currently
supported services are:
tdoauth opens the browser and initiates a
connection to the service's authorization page. You will be prompted to log
in and then to authorize
TDcal to access your
calendar. Once you have granted permission, the OAuth access tokens are
returned and automatically saved in your calendar's configuration. If you
delete the calendar from your
file, the access tokens will be removed on the next sync. You will then need
tdoauth again if you decide to re-add the
You can then, finally, use the other
tools to access your calendar on the OAuth service.
tdoauth supports the following
tdoauthutility exits 0 on success, and >0 if an error occurs.
|September 23, 2021||FreeBSD 13.0-RELEASE|