drone/internal/auth/authn/authenticator.go
Johannes Batzill 1115a5083b Add Paths support and error improvements (#11)
This change is adding the concept of Paths.
A repository and space always have a Primary Path which always is represents the ancestry to the root space.
All access history / resource visibility / child listings / UI traversal / etc. is done via that path.

Additionally, repos and spaces can have Alias Paths, which as the name states are aliases. via the primary path.
They sole impact is that a space or repo can be reached via different paths from the UI / rest apis / git apis.
This fulfills two major purposes:
- Customers can rename or move projects and spaces without breaking any existing references from CI pipeliens / code bases / local repos / ...
- Customer can create shorter aliases for important repos when in harness embeded mode! (acc/org/proj/repo can be shortened to acc/repo, or acc/repo'

Apart from the path changes, this PR adds:

Improved User facing errors
Improved internal error handling and wrapping
update / rename operation for repo and space
path list / delete / create operation for repo and space
2022-09-08 21:39:15 -07:00

27 lines
749 B
Go

// Copyright 2022 Harness Inc. All rights reserved.
// Use of this source code is governed by the Polyform Free Trial License
// that can be found in the LICENSE.md file for this repository.
package authn
import (
"net/http"
"github.com/harness/gitness/types"
)
/*
* An abstraction of an entity thats responsible for authenticating users
* that are making calls via HTTP.
*/
type Authenticator interface {
/*
* Tries to authenticate a user if credentials are available.
* Returns:
* (user, nil) - request contained auth data and user was verified
* (nil, err) - request contained auth data but verification failed
* (nil, nil) - request didn't contain any auth data
*/
Authenticate(r *http.Request) (*types.User, error)
}