Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chalmeal/go-gin-auth
Go(Gin)とJSON Web Tokenを利用した認証認可
https://github.com/chalmeal/go-gin-auth
gin go-api go-example go-rest-api golang jwt rest-api
Last synced: 9 days ago
JSON representation
Go(Gin)とJSON Web Tokenを利用した認証認可
- Host: GitHub
- URL: https://github.com/chalmeal/go-gin-auth
- Owner: chalmeal
- Created: 2024-04-25T08:13:59.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-05-14T00:20:27.000Z (6 months ago)
- Last Synced: 2024-05-14T13:58:04.891Z (6 months ago)
- Topics: gin, go-api, go-example, go-rest-api, golang, jwt, rest-api
- Language: Go
- Homepage:
- Size: 38.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
**go-gin-auth**
Golang + Gin + Auth(JWT)
## はじめに
当プロジェクトはGolangとGinを利用したログイン認証及びアクセス認可です。JWTを利用したシンプルな実装で構成しています。
## 構成
```
├── main.go
├── common
| ├── connect
| | └── db.go
| ├── sessions
| └── sessions.go
| └── response
| └── response.go
├── config
| ├── app.ini
| └── config.go
└── routers
├── routers.go
└── api
├── api.go
├── auths
| ├── routes.go
| ├── app_auth_controllers.go
| ├── model.go
| ├── middleware.go
| ├── utils.go
| └── validators.go
└── books
├── routes.go
├── book_controllers.go
├── model.go
├── middleware.go
└── validators.go
```
## ドキュメント
### データ定義
| テーブル名 | 概要 |
|-----------|------------|
| [users](https://github.com/chalmeal/go-gin-auth/blob/master/.doc/data/users.md) | ユーザーテーブル、認証情報の管理を含む|
| [books](https://github.com/chalmeal/go-gin-auth/blob/master/.doc/data/books.md) | 書籍マスタテーブル |
### 仕様
| 書名 | 概要 |
|-----------|------------|
| [認証認可](https://github.com/chalmeal/go-gin-auth/blob/master/.doc/method/%E8%AA%8D%E8%A8%BC%E8%AA%8D%E5%8F%AF.md) | ユーザー認証をする機能について |
## セットアップ
### DB
* DBの環境は以下を想定します。
* MySQL
* GORM
* create schemaのみ行う必要があります。[DDL](.db/setup/ddl-create-chema.sql)
* [app.ini](config/app.ini)に対してDB接続情報を定義してください。
* テーブルはGORMが提供するAutoMigrateを利用します。
* 各テーブルは初回API実行時に生成されます。
* テストレコードを追加したい場合は[dml-insert-into_users.sql](https://github.com/chalmeal/go-gin-auth/blob/master/.db/setup/dml-insert-into_users.sql)及び[dml-insert-into_books.sql](https://github.com/chalmeal/go-gin-auth/blob/master/.db/setup/dml-insert-into_books.sql)を参考に実行してください。
* 本プロジェクトで定義されている詳細なデータ定義に関しては、各ドメインのdocを参照してください。
* ユーザー：[users](https://github.com/chalmeal/go-gin-auth/blob/master/.doc/auth/App/App-Auth.md)
* 書籍マスタ：[books](https://github.com/chalmeal/go-gin-auth/blob/master/.doc/books/books.md)
## アプリケーションスタート
アプリケーションのスタートはデバッガを推奨しています。
Run and Debugの`Run go-gin-auth`から実行してください。
## その他
**Qiita**
* [【Golang + Gin】JSON Web Token(JWT)でサクっとREST-API実装](https://qiita.com/chalmeal/items/740bf98c64a9a341da54#%E6%88%90%E6%9E%9C%E7%89%A9)
* [【Golang + Gin】JWT + sessionsでログインセッション管理]()