https://github.com/zaker/oauth2local
An oauth client providing authenticated tokens to local processes.
https://github.com/zaker/oauth2local
oauth2
Last synced: 4 months ago
JSON representation
An oauth client providing authenticated tokens to local processes.
- Host: GitHub
- URL: https://github.com/zaker/oauth2local
- Owner: zaker
- License: lgpl-3.0
- Created: 2019-03-21T09:38:36.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-07-22T13:52:56.000Z (11 months ago)
- Last Synced: 2025-08-01T12:16:47.257Z (10 months ago)
- Topics: oauth2
- Language: Go
- Homepage:
- Size: 7.33 MB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://dev.azure.com/lambdaville/oauth2local/_build/latest?definitionId=1&branchName=master)
# oauth2local
An oauth client providing authenticated tokens to local processes.
```plain
oauth2local is providing oauth2 authenticated tokens to local processes
Usage:
oauth2local [command]
Available Commands:
callback Send callback url to sovereign
defaults Writes default config values to config file
help Help about any command
register Register app as url handler for custom url
serve serve a local auth provider
token Gets access token from the local server instance
Flags:
--config string config file (default is $HOME/.oauth2local.yaml)
-h, --help help for oauth2local
--verbose log to console to console
Use "oauth2local [command] --help" for more information about a command.
```
## How to setup
Running the command should register the application as a custom url handler for "loc-auth://"
```bash
oauth2local register
```
this may need administrative privileges on windows
To test if the registration is successfull, run this command and see if there is a response from the server
```bash
oaut2local serve && xdg-open loc-auth://callback?code=foo
```
Getting a token when the server is up and running
```bash
oaut2local token
```
## Build from source
### Dependencies
- Go >=v1.19
- Protoc >=v3.7
### Generate GRPC server/client
```bash
protoc --go_out=ipc/localauth --go_opt=paths=source_relative --go-grpc_out=ipc/localauth --go-grpc_opt=paths=source_relative .\ipc\locauth.proto
```
### Build
```bash
go build -v .
```