mirror of
https://github.com/go-gitea/gitea.git
synced 2026-08-29 02:04:15 +00:00
ToastyTheBot
646ea0f253
Deploy keys only work over SSH. A deploy token is their counterpart for HTTPS: a repository scoped credential, used as the password of a Git request, with read or read and write access. It covers Git operations and LFS, and can be regenerated in place. Signed-off-by: silverwind <me@silverwind.io> Co-authored-by: Claude Mythos <noreply@anthropic.com> Co-authored-by: silverwind <me@silverwind.io> Co-authored-by: bircni <bircni@icloud.com> Co-authored-by: wxiaoguang <wxiaoguang@gmail.com>
61 lines
1.8 KiB
Go
61 lines
1.8 KiB
Go
// Copyright 2015 The Gogs Authors. All rights reserved.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package structs
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
type DeployKey struct {
|
|
// ID is the unique identifier for the deploy-key
|
|
ID int64 `json:"id"`
|
|
// Type tells whether the key authenticates over SSH or with a token over HTTPS
|
|
// enum: ssh,token
|
|
KeyType string `json:"key_type"`
|
|
// KeyID is the associated public key ID
|
|
KeyID int64 `json:"key_id"`
|
|
// Key contains the actual SSH key content
|
|
Key string `json:"key"`
|
|
// URL is the API URL for this deploy-key
|
|
URL string `json:"url"`
|
|
// Title is the human-readable name for the key
|
|
Title string `json:"title"`
|
|
// Fingerprint is the key's fingerprint
|
|
Fingerprint string `json:"fingerprint"`
|
|
// Token is the plaintext token of an HTTPS key, only returned when it is created
|
|
Token string `json:"token,omitempty"`
|
|
// swagger:strfmt date-time
|
|
// Created is the time when the deploy-key was added
|
|
Created time.Time `json:"created_at"`
|
|
// ReadOnly indicates if the key has read-only access
|
|
ReadOnly bool `json:"read_only"`
|
|
// Repository is the repository this deploy-key belongs to
|
|
Repository *Repository `json:"repository,omitempty"`
|
|
}
|
|
|
|
type CreateKeyOption struct {
|
|
// Title of the key to add
|
|
//
|
|
// required: true
|
|
// unique: true
|
|
Title string `json:"title" binding:"Required"`
|
|
// An armored SSH key to add
|
|
//
|
|
// required: true
|
|
// unique: true
|
|
Key string `json:"key" binding:"Required"`
|
|
// Describe if the key has only read access or read/write
|
|
ReadOnly bool `json:"read_only"`
|
|
}
|
|
|
|
type CreateDeployKeyTokenOption struct {
|
|
// Title of the token to add
|
|
//
|
|
// required: true
|
|
// unique: true
|
|
Title string `json:"title" binding:"Required;MaxSize(50)"`
|
|
// Describe if the token has only read access or read/write
|
|
ReadOnly bool `json:"read_only"`
|
|
}
|