Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peburrows/goth
Elixir package for Oauth authentication via Google Cloud APIs
https://github.com/peburrows/goth
authentication elixir gcp google google-cloud-platform
Last synced: about 2 months ago
JSON representation
Elixir package for Oauth authentication via Google Cloud APIs
- Host: GitHub
- URL: https://github.com/peburrows/goth
- Owner: peburrows
- License: mit
- Created: 2016-01-20T05:41:14.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-19T08:21:03.000Z (about 2 months ago)
- Last Synced: 2024-04-27T02:02:35.976Z (about 2 months ago)
- Topics: authentication, elixir, gcp, google, google-cloud-platform
- Language: Elixir
- Homepage: http://hexdocs.pm/goth
- Size: 289 KB
- Stars: 274
- Watchers: 7
- Forks: 105
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Lists
- awesome-elixir - goth - OAuth 2.0 library for server to server applications via Google Cloud APIs. (Authentication)
- freaking_awesome_elixir - Elixir - OAuth 2.0 library for server to server applications via Google Cloud APIs. (Authentication)
- jimsghstars - peburrows/goth - Elixir package for Oauth authentication via Google Cloud APIs (Elixir)
- jimsghstars - peburrows/goth - Elixir package for Oauth authentication via Google Cloud APIs (Elixir)
- awesome-elixir - goth - OAuth 2.0 library for server to server applications via Google Cloud APIs. (Authentication)
- fucking-awesome-elixir - goth - OAuth 2.0 library for server to server applications via Google Cloud APIs. (Authentication)
README
# Goth
Google + Auth = Goth
A simple library to generate and retrieve OAuth2 tokens for use with Google
Cloud Service accounts.
## Installation
**Note:** below are instructions for using Goth v1.3+. For more information on
earlier versions of Goth, [see v1.2.0 documentation on hexdocs.pm](https://hexdocs.pm/goth/1.2.0).
1. Add `:goth` to your list of dependencies in `mix.exs`.
```elixir
def deps do
[
{:goth, "~> 1.3"}
]
end
```
2. Add Goth to your supervision tree:
```elixir
defmodule MyApp.Application do
use Application
def start(_type, _args) do
credentials =
"GOOGLE_APPLICATION_CREDENTIALS_JSON"
|> System.fetch_env!()
|> Jason.decode!()
source = {:service_account, credentials}
children = [
{Goth, name: MyApp.Goth, source: source}
]
Supervisor.start_link(children, strategy: :one_for_one)
end
end
```
If you set `GOOGLE_APPLICATION_CREDENTIALS` or
`GOOGLE_APPLICATION_CREDENTIALS_JSON`, have a
`~/.config/gcloud/application_default_credentials.json` file,
`~/.config/gcloud/configurations/config_default` file or deploy
your application to Google Cloud, you can omit the `:source` option:
```elixir
def start(_type, _args) do
children = [
{Goth, name: MyApp.Goth}
]
Supervisor.start_link(children, strategy: :one_for_one)
end
```
If you want to use multiple credentials, you may consider doing:
```elixir
def start(_type, _args) do
Supervisor.start_link(servers(), strategy: :one_for_one)
end
defp servers do
servers = [
{MyApp.Cred1, source1},
...
{MyApp.CredN, source2}
]
for {name, source} <- servers do
Supervisor.child_spec({Goth, name: name, source: source}, id: name)
end
end
```
3. Fetch the token:
```elixir
iex> Goth.fetch!(MyApp.Goth)
%Goth.Token{
expires: 1453356568,
token: "ya29.cALlJ4ICWRvMkYB-WsAR-CZnExE459PA7QPqKg5nei9y2T9-iqmbcgxq8XrTATNn_BPim",
type: "Bearer",
...
}
```
See `Goth.start_link/1` for more information about possible configuration options.
## Upgrading from Goth 1.2
See [Upgrading from Goth 1.2](UPGRADE_GUIDE.md) guide for more information.
## Community resources
- [How to upload on YouTube Data API with elixir ?](https://mrdotb.com/posts/upload-on-youtube-with-elixir/)
## Copyright and License
Copyright (c) 2016 Phil Burrows
This work is free. You can redistribute it and/or modify it under the terms of
the MIT License. See the [LICENSE.md](./LICENSE.md) file for more details.