2017-04-21 00:40:52 +02:00
|
|
|
// Copyright 2017 Vector Creations Ltd
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
2017-05-23 18:43:05 +02:00
|
|
|
// Package auth implements authentication checks and storage.
|
2017-03-07 14:43:32 +01:00
|
|
|
package auth
|
|
|
|
|
|
|
|
import (
|
2017-09-18 16:51:26 +02:00
|
|
|
"context"
|
2017-05-30 18:51:40 +02:00
|
|
|
"crypto/rand"
|
|
|
|
"encoding/base64"
|
2017-03-07 14:43:32 +01:00
|
|
|
"fmt"
|
|
|
|
"net/http"
|
|
|
|
"strings"
|
|
|
|
|
2017-05-23 18:43:05 +02:00
|
|
|
"github.com/matrix-org/dendrite/clientapi/auth/authtypes"
|
2017-03-07 14:43:32 +01:00
|
|
|
"github.com/matrix-org/dendrite/clientapi/jsonerror"
|
2020-06-16 15:10:55 +02:00
|
|
|
"github.com/matrix-org/dendrite/userapi/api"
|
2017-03-07 14:43:32 +01:00
|
|
|
"github.com/matrix-org/util"
|
|
|
|
)
|
|
|
|
|
2017-05-30 18:51:40 +02:00
|
|
|
// OWASP recommends at least 128 bits of entropy for tokens: https://www.owasp.org/index.php/Insufficient_Session-ID_Length
|
|
|
|
// 32 bytes => 256 bits
|
|
|
|
var tokenByteLength = 32
|
|
|
|
|
2017-07-17 18:20:57 +02:00
|
|
|
// DeviceDatabase represents a device database.
|
|
|
|
type DeviceDatabase interface {
|
2017-08-23 16:08:48 +02:00
|
|
|
// Look up the device matching the given access token.
|
2020-06-16 15:10:55 +02:00
|
|
|
GetDeviceByAccessToken(ctx context.Context, token string) (*api.Device, error)
|
2017-07-17 18:20:57 +02:00
|
|
|
}
|
|
|
|
|
2018-06-01 13:16:19 +02:00
|
|
|
// AccountDatabase represents an account database.
|
|
|
|
type AccountDatabase interface {
|
|
|
|
// Look up the account matching the given localpart.
|
|
|
|
GetAccountByLocalpart(ctx context.Context, localpart string) (*authtypes.Account, error)
|
|
|
|
}
|
|
|
|
|
|
|
|
// VerifyUserFromRequest authenticates the HTTP request,
|
2018-07-17 00:17:03 +02:00
|
|
|
// on success returns Device of the requester.
|
2018-06-01 13:16:19 +02:00
|
|
|
// Finds local user or an application service user.
|
2018-07-17 00:17:03 +02:00
|
|
|
// Note: For an AS user, AS dummy device is returned.
|
2018-06-01 13:16:19 +02:00
|
|
|
// On failure returns an JSON error response which can be sent to the client.
|
|
|
|
func VerifyUserFromRequest(
|
2020-06-16 15:10:55 +02:00
|
|
|
req *http.Request, userAPI api.UserInternalAPI,
|
|
|
|
) (*api.Device, *util.JSONResponse) {
|
2018-06-01 13:16:19 +02:00
|
|
|
// Try to find the Application Service user
|
2018-07-23 15:40:35 +02:00
|
|
|
token, err := ExtractAccessToken(req)
|
2018-06-01 13:16:19 +02:00
|
|
|
if err != nil {
|
2018-07-17 00:17:03 +02:00
|
|
|
return nil, &util.JSONResponse{
|
2018-06-01 13:16:19 +02:00
|
|
|
Code: http.StatusUnauthorized,
|
|
|
|
JSON: jsonerror.MissingToken(err.Error()),
|
|
|
|
}
|
|
|
|
}
|
2020-06-16 15:10:55 +02:00
|
|
|
var res api.QueryAccessTokenResponse
|
|
|
|
err = userAPI.QueryAccessToken(req.Context(), &api.QueryAccessTokenRequest{
|
|
|
|
AccessToken: token,
|
|
|
|
AppServiceUserID: req.URL.Query().Get("user_id"),
|
|
|
|
}, &res)
|
|
|
|
if err != nil {
|
|
|
|
util.GetLogger(req.Context()).WithError(err).Error("userAPI.QueryAccessToken failed")
|
|
|
|
jsonErr := jsonerror.InternalServerError()
|
|
|
|
return nil, &jsonErr
|
2018-06-01 13:16:19 +02:00
|
|
|
}
|
2020-06-16 15:10:55 +02:00
|
|
|
if res.Err != nil {
|
|
|
|
if forbidden, ok := res.Err.(*api.ErrorForbidden); ok {
|
2018-07-17 00:17:03 +02:00
|
|
|
return nil, &util.JSONResponse{
|
|
|
|
Code: http.StatusForbidden,
|
2020-06-16 15:10:55 +02:00
|
|
|
JSON: jsonerror.Forbidden(forbidden.Message),
|
2018-07-17 00:17:03 +02:00
|
|
|
}
|
2018-06-01 13:16:19 +02:00
|
|
|
}
|
2019-03-21 15:48:21 +01:00
|
|
|
}
|
2020-06-16 15:10:55 +02:00
|
|
|
if res.Device == nil {
|
|
|
|
return nil, &util.JSONResponse{
|
2018-03-13 16:55:45 +01:00
|
|
|
Code: http.StatusUnauthorized,
|
2020-06-16 15:10:55 +02:00
|
|
|
JSON: jsonerror.UnknownToken("Unknown token"),
|
2017-05-23 18:43:05 +02:00
|
|
|
}
|
2017-03-07 14:43:32 +01:00
|
|
|
}
|
2020-06-16 15:10:55 +02:00
|
|
|
return res.Device, nil
|
2017-03-07 14:43:32 +01:00
|
|
|
}
|
|
|
|
|
2017-05-30 18:51:40 +02:00
|
|
|
// GenerateAccessToken creates a new access token. Returns an error if failed to generate
|
|
|
|
// random bytes.
|
|
|
|
func GenerateAccessToken() (string, error) {
|
|
|
|
b := make([]byte, tokenByteLength)
|
|
|
|
if _, err := rand.Read(b); err != nil {
|
|
|
|
return "", err
|
|
|
|
}
|
|
|
|
// url-safe no padding
|
|
|
|
return base64.RawURLEncoding.EncodeToString(b), nil
|
|
|
|
}
|
|
|
|
|
2018-07-23 15:40:35 +02:00
|
|
|
// ExtractAccessToken from a request, or return an error detailing what went wrong. The
|
2017-03-07 14:43:32 +01:00
|
|
|
// error message MUST be human-readable and comprehensible to the client.
|
2018-07-23 15:40:35 +02:00
|
|
|
func ExtractAccessToken(req *http.Request) (string, error) {
|
2017-03-07 14:43:32 +01:00
|
|
|
// cf https://github.com/matrix-org/synapse/blob/v0.19.2/synapse/api/auth.py#L631
|
|
|
|
authBearer := req.Header.Get("Authorization")
|
|
|
|
queryToken := req.URL.Query().Get("access_token")
|
|
|
|
if authBearer != "" && queryToken != "" {
|
|
|
|
return "", fmt.Errorf("mixing Authorization headers and access_token query parameters")
|
|
|
|
}
|
|
|
|
|
|
|
|
if queryToken != "" {
|
|
|
|
return queryToken, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
if authBearer != "" {
|
|
|
|
parts := strings.SplitN(authBearer, " ", 2)
|
|
|
|
if len(parts) != 2 || parts[0] != "Bearer" {
|
|
|
|
return "", fmt.Errorf("invalid Authorization header")
|
|
|
|
}
|
|
|
|
return parts[1], nil
|
|
|
|
}
|
|
|
|
|
|
|
|
return "", fmt.Errorf("missing access token")
|
|
|
|
}
|