florian
/
hostname-service
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: florian:c08de789840f95065f407dc0c75e42a32cdc2b4a
Branches Tags
florian:main
..
compare: florian:e0190f4bb5a23db01a0219bbae5004436ac35e54
Branches Tags
florian:main

No commits in common. "c08de789840f95065f407dc0c75e42a32cdc2b4a" and "e0190f4bb5a23db01a0219bbae5004436ac35e54" have entirely different histories.
c08de78984 ... e0190f4bb5

10 changed files with 123 additions and 279 deletions
Show Stats Expand all files Collapse all files

13
api/handlers.go
View File

@ -6,7 +6,6 @@ import (
"strings"
"git.beisel.it/florian/hostname-service/db"
"git.beisel.it/florian/hostname-service/models"
"git.beisel.it/florian/hostname-service/rules"
"github.com/gin-gonic/gin"
)
@ -66,8 +65,7 @@ func CreateOrUpdateHostname(c *gin.Context, isUpdate bool) {
return
}
response := models.SimpleHostnameResponse{Hostname: hostname}
c.JSON(http.StatusOK, response)
c.JSON(http.StatusOK, gin.H{"hostname": hostname})
}
// @Summary Delete a hostname from the database
@ -76,7 +74,7 @@ func CreateOrUpdateHostname(c *gin.Context, isUpdate bool) {
// @Produce json
// @Param category path string true "Category of the hostname"
// @Param hostname path string true "Hostname to delete"
// @Success 200 {object} models.SimpleHostnameResponse "Hostname"
// @Success 200 {json} json "Hostname"
// @Security Bearer
// @Tags Manipulate existing Hostnames
// @Router /{category}/{hostname} [delete]
@ -89,8 +87,7 @@ func DeleteHostname(c *gin.Context) {
c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
return
}
response := models.SimpleHostnameResponse{Hostname: hostname}
c.JSON(http.StatusOK, response)
c.JSON(http.StatusOK, gin.H{"hostname": hostname})
}
// @Summary Return a list of hosts and their details filtered by category
@ -98,7 +95,7 @@ func DeleteHostname(c *gin.Context) {
// @ID list-hostnames-by-category
// @Produce json
// @Param category path string true "Category of the hostname"
// @Success 200 {array} models.Hostname "An array of responses"
// @Success 200 {json} json "Hostname"
// @Security Bearer
// @Tags Querying Hostnames
// @Router /{category} [get]
@ -123,8 +120,8 @@ func ListHostnamesByCategory(c *gin.Context) {
// @Produce json
// @Param category path string true "Category of the hostname"
// @Param hostname path string true "Category of the hostname"
// @Success 200 {object} models.Hostname "A single response object"
// @Security Bearer
// @Success 200 {json} json "Hostname"
// @Tags Querying Hostnames
// @Router /{category}/{hostname} [get]
func GetHostnameByCategoryAndName(c *gin.Context) {

9
auth/handlers.go
View File

@ -12,17 +12,16 @@ import (
)
// LoginHandler godoc
//
// @Summary User login
// @Description Authenticate user and return JWT token
// @Tags Authentication
// @Accept json
// @Produce json
// @Param loginCredentials body models.LoginCredentials true "Login Credentials"
// @Success 200 {object} models.TokenResponse "Successfully authenticated, JWT token returned"
// @Failure 400 {object} models.ErrorResponse "Invalid request body"
// @Failure 401 {object} models.ErrorResponse "Invalid login credentials"
// @Failure 500 {object} models.ErrorResponse "Internal server error"
// @Success 200 {object} map[string]string "Successfully authenticated, JWT token returned"
// @Failure 400 {object} map[string]string "Invalid request body"
// @Failure 401 {object} map[string]string "Invalid login credentials"
// @Failure 500 {object} map[string]string "Internal server error"
// @Router /login [post]
func LoginHandler(c *gin.Context) {
var creds models.LoginCredentials

99
docs/docs.go
View File

@ -52,7 +52,7 @@ const docTemplate = `{
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "string"
}
}
}
@ -85,7 +85,7 @@ const docTemplate = `{
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "string"
}
}
}
@ -148,25 +148,37 @@ const docTemplate = `{
"200": {
"description": "Successfully authenticated, JWT token returned",
"schema": {
"$ref": "#/definitions/models.TokenResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"400": {
"description": "Invalid request body",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"401": {
"description": "Invalid login credentials",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"500": {
"description": "Internal server error",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
}
}
@ -199,12 +211,9 @@ const docTemplate = `{
],
"responses": {
"200": {
"description": "An array of responses",
"description": "Hostname",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Hostname"
}
"type": "json"
}
}
}
@ -244,9 +253,9 @@ const docTemplate = `{
],
"responses": {
"200": {
"description": "A single response object",
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.Hostname"
"type": "json"
}
}
}
@ -286,7 +295,7 @@ const docTemplate = `{
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "json"
}
}
}
@ -294,72 +303,14 @@ const docTemplate = `{
}
},
"definitions": {
"models.ErrorResponse": {
"type": "object",
"properties": {
"error": {
"type": "string"
}
}
},
"models.Hostname": {
"description": "Model of the Hostname as it is represented in the database",
"type": "object",
"properties": {
"Category": {
"description": "Category / Rule that was used when generating the hostname",
"type": "string",
"example": "notebook"
},
"Created_at": {
"description": "Creation Time of the entry",
"type": "string",
"example": "2024-01-16T12:53:59Z"
},
"Hostname": {
"description": "Generated hostname",
"type": "string",
"example": "ISEHENNB0009"
},
"Id": {
"description": "Internal ID of the Hostname within the database",
"type": "integer",
"example": 25
},
"Parameters": {
"description": "Parameter object of rule specific attributes, see rule.* models",
"type": "object",
"additionalProperties": true
}
}
},
"models.LoginCredentials": {
"description": "User account information used in the login process with Username and password",
"type": "object",
"properties": {
"Password": {
"password": {
"type": "string"
},
"Username": {
"type": "string"
}
}
},
"models.SimpleHostnameResponse": {
"description": "Model of the Hostname as returned by POST endpoint",
"type": "object",
"properties": {
"Hostname": {
"description": "Name of the newly generated host",
"type": "string"
}
}
},
"models.TokenResponse": {
"description": "Model returned after successful login",
"type": "object",
"properties": {
"token": {
"username": {
"type": "string"
}
}

99
docs/swagger.json
View File

@ -46,7 +46,7 @@
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "string"
}
}
}
@ -79,7 +79,7 @@
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "string"
}
}
}
@ -142,25 +142,37 @@
"200": {
"description": "Successfully authenticated, JWT token returned",
"schema": {
"$ref": "#/definitions/models.TokenResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"400": {
"description": "Invalid request body",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"401": {
"description": "Invalid login credentials",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"500": {
"description": "Internal server error",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"type": "object",
"additionalProperties": {
"type": "string"
}
}
}
}
@ -193,12 +205,9 @@
],
"responses": {
"200": {
"description": "An array of responses",
"description": "Hostname",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Hostname"
}
"type": "json"
}
}
}
@ -238,9 +247,9 @@
],
"responses": {
"200": {
"description": "A single response object",
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.Hostname"
"type": "json"
}
}
}
@ -280,7 +289,7 @@
"200": {
"description": "Hostname",
"schema": {
"$ref": "#/definitions/models.SimpleHostnameResponse"
"type": "json"
}
}
}
@ -288,72 +297,14 @@
}
},
"definitions": {
"models.ErrorResponse": {
"type": "object",
"properties": {
"error": {
"type": "string"
}
}
},
"models.Hostname": {
"description": "Model of the Hostname as it is represented in the database",
"type": "object",
"properties": {
"Category": {
"description": "Category / Rule that was used when generating the hostname",
"type": "string",
"example": "notebook"
},
"Created_at": {
"description": "Creation Time of the entry",
"type": "string",
"example": "2024-01-16T12:53:59Z"
},
"Hostname": {
"description": "Generated hostname",
"type": "string",
"example": "ISEHENNB0009"
},
"Id": {
"description": "Internal ID of the Hostname within the database",
"type": "integer",
"example": 25
},
"Parameters": {
"description": "Parameter object of rule specific attributes, see rule.* models",
"type": "object",
"additionalProperties": true
}
}
},
"models.LoginCredentials": {
"description": "User account information used in the login process with Username and password",
"type": "object",
"properties": {
"Password": {
"password": {
"type": "string"
},
"Username": {
"type": "string"
}
}
},
"models.SimpleHostnameResponse": {
"description": "Model of the Hostname as returned by POST endpoint",
"type": "object",
"properties": {
"Hostname": {
"description": "Name of the newly generated host",
"type": "string"
}
}
},
"models.TokenResponse": {
"description": "Model returned after successful login",
"type": "object",
"properties": {
"token": {
"username": {
"type": "string"
}
}

78
docs/swagger.yaml
View File

@ -1,54 +1,12 @@
basePath: /api/v1
definitions:
models.ErrorResponse:
properties:
error:
type: string
type: object
models.Hostname:
description: Model of the Hostname as it is represented in the database
properties:
Category:
description: Category / Rule that was used when generating the hostname
example: notebook
type: string
Created_at:
description: Creation Time of the entry
example: "2024-01-16T12:53:59Z"
type: string
Hostname:
description: Generated hostname
example: ISEHENNB0009
type: string
Id:
description: Internal ID of the Hostname within the database
example: 25
type: integer
Parameters:
additionalProperties: true
description: Parameter object of rule specific attributes, see rule.* models
type: object
type: object
models.LoginCredentials:
description: User account information used in the login process with Username
and password
properties:
Password:
password:
type: string
Username:
type: string
type: object
models.SimpleHostnameResponse:
description: Model of the Hostname as returned by POST endpoint
properties:
Hostname:
description: Name of the newly generated host
type: string
type: object
models.TokenResponse:
description: Model returned after successful login
properties:
token:
username:
type: string
type: object
rules.NotebookRuleInput:
@ -85,11 +43,9 @@ paths:
- application/json
responses:
"200":
description: An array of responses
description: Hostname
schema:
items:
$ref: '#/definitions/models.Hostname'
type: array
type: json
security:
- Bearer: []
summary: Return a list of hosts and their details filtered by category
@ -116,7 +72,7 @@ paths:
"200":
description: Hostname
schema:
$ref: '#/definitions/models.SimpleHostnameResponse'
type: json
security:
- Bearer: []
summary: Delete a hostname from the database
@ -140,9 +96,9 @@ paths:
- application/json
responses:
"200":
description: A single response object
description: Hostname
schema:
$ref: '#/definitions/models.Hostname'
type: json
security:
- Bearer: []
summary: Return a single hostname by Category and Name
@ -167,7 +123,7 @@ paths:
"200":
description: Hostname
schema:
$ref: '#/definitions/models.SimpleHostnameResponse'
type: string
summary: Generate hostname for category "notebook"
tags:
- Generating Hostnames
@ -189,7 +145,7 @@ paths:
"200":
description: Hostname
schema:
$ref: '#/definitions/models.SimpleHostnameResponse'
type: string
summary: Update hostname for category "notebook"
tags:
- Generating Hostnames
@ -229,19 +185,27 @@ paths:
"200":
description: Successfully authenticated, JWT token returned
schema:
$ref: '#/definitions/models.TokenResponse'
additionalProperties:
type: string
type: object
"400":
description: Invalid request body
schema:
$ref: '#/definitions/models.ErrorResponse'
additionalProperties:
type: string
type: object
"401":
description: Invalid login credentials
schema:
$ref: '#/definitions/models.ErrorResponse'
additionalProperties:
type: string
type: object
"500":
description: Internal server error
schema:
$ref: '#/definitions/models.ErrorResponse'
additionalProperties:
type: string
type: object
summary: User login
tags:
- Authentication

5
models/error.go
View File

@ -1,5 +0,0 @@
package models
type ErrorResponse struct {
Error string `json:"error"`
}

17
models/hostname.go
View File

@ -6,16 +6,9 @@ import "time"
// @Description Model of the Hostname as it
// @Description is represented in the database
type Hostname struct {
ID int `json:"Id" example:"25"` // Internal ID of the Hostname within the database
Category string `json:"Category" example:"notebook"` // Category / Rule that was used when generating the hostname
Hostname string `json:"Hostname" example:"ISEHENNB0009"` // Generated hostname
Parameters map[string]interface{} `json:"Parameters"` // Parameter object of rule specific attributes, see rule.* models
CreatedAt time.Time `json:"Created_at" example:"2024-01-16T12:53:59Z"` // Creation Time of the entry
}
// SimpleHostnameResponse
// @Description Model of the Hostname as returned by
// @Description POST endpoint
type SimpleHostnameResponse struct {
Hostname string `json:"Hostname"` // Name of the newly generated host
ID int `json:"id"` // Internal ID of the Hostname within the database
Category string `json:"category"` // Category / Rule that was used when generating the hostname
Hostname string `json:"hostname"` // Generated hostname
Parameters map[string]interface{} `json:"parameters"` // Parameter object of rule specific attributes
CreatedAt time.Time `json:"created_at"` // Creation Time of the entry
}

10
models/login.go
View File

@ -4,12 +4,6 @@ package models
// @Description User account information used in the login process
// @Description with Username and password
type LoginCredentials struct {
Username string `json:"Username"`
Password string `json:"Password"`
}
// JWT Token Response Model
// @Description Model returned after successful login
type TokenResponse struct {
Token string `json:"token"`
Username string `json:"username"`
Password string `json:"password"`
}

2
rules/interface.go
View File

@ -32,7 +32,7 @@ func (br *BaseRule) baseInsert(category string, hostname string, paramsJSON []by
}
func (br *BaseRule) baseUpdate(category string, oldhostname string, hostname string, paramsJSON []byte) error {
exists, err := db.HostnameExists(category, oldhostname)
exists, err := db.HostnameExists(category, hostname)
if err != nil {
return fmt.Errorf("error checking existence of hostname: %v", err.Error())
}

4
rules/notebook.go
View File

@ -73,7 +73,7 @@ func (nr *NotebookRule) Generate(params map[string]interface{}) (string, []byte,
// @Produce json
// @Tags Generating Hostnames
// @Param body body NotebookRuleInput true "Input data to generate hostname"
// @Success 200 {object} models.SimpleHostnameResponse "Hostname"
// @Success 200 {string} string "Hostname"
// @Router /api/notebook [post]
func (nr *NotebookRule) Insert(category string, hostname string, paramsJSON []byte) error {
return nr.baseInsert(category, hostname, paramsJSON)
@ -86,7 +86,7 @@ func (nr *NotebookRule) Insert(category string, hostname string, paramsJSON []by
// @Produce json
// @Tags Generating Hostnames
// @Param body body NotebookRuleInput true "Input data to generate hostname"
// @Success 200 {object} models.SimpleHostnameResponse "Hostname"
// @Success 200 {string} string "Hostname"
// @Router /api/notebook [put]
func (nr *NotebookRule) Update(category string, oldhostname string, hostname string, paramsJSON []byte) error {
return nr.baseUpdate(category, oldhostname, hostname, paramsJSON)