claim

package
v0.0.0-...-b986fe3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 8, 2024 License: MIT Imports: 9 Imported by: 1

Documentation

Index

Constants

View Source
const (
	SubMaxLength = 255
)

Variables

View Source
var (
	ErrIssScheme          = errors.New("scheme of issuer URL must be https")
	ErrIssQueryOrFragment = errors.New("issuer URL must not have query or fragment")
	ErrSubLength          = errors.New("subject must not exceed 255 ASCII characters in length")
	ErrBirthdateMalformed = errors.New("malformed birthdate")
)
View Source
var (
	DefaultRegistry = claim.DefaultRegistry.Clone()
)

Functions

This section is empty.

Types

type Acr

type Acr string

Acr is the authentication context class reference.

func NewAcr

func NewAcr(s string) *Acr

func (Acr) ClaimName

func (c Acr) ClaimName() string

type Address

type Address struct {
	// Formatted is full mailing address, formatted for display or use on a mailing label. This field MAY contain
	// multiple lines, separated by newlines. Newlines can be represented either as a carriage return/line feed pair
	// ("\r\n") or as a single line feed character ("\n").
	Formatted string `json:"formatted,omitempty"`

	// StreetAddress is full street address component, which MAY include house number, street name, Post Office Box, and
	// multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
	// Newlines can be represented either as a carriage return/line feed pair ("\r\n") or as a single line feed
	// character ("\n").
	StreetAddress string `json:"street_address,omitempty"`

	// Locality is city or locality component.
	Locality string `json:"locality,omitempty"`

	// Region is state, province, prefecture, or region component.
	Region string `json:"region,omitempty"`

	// PostalCode is zip code or postal code component.
	PostalCode string `json:"postal_code,omitempty"`

	// Country is country name component.
	Country string `json:"country,omitempty"`
}

func (*Address) ClaimName

func (c *Address) ClaimName() string

type Amr

type Amr []string

Amr is the authentication methods references.

func NewAmr

func NewAmr(s []string) *Amr

func (Amr) ClaimName

func (c Amr) ClaimName() string

type Aud

type Aud = claim.Aud

type AuthTime

type AuthTime time.Time

AuthTime is the time when the end-user authentication occurred.

func AuthTimeFromInt64

func AuthTimeFromInt64(i int64) *AuthTime

func NewAuthTime

func NewAuthTime(t time.Time) *AuthTime

func (AuthTime) ClaimName

func (c AuthTime) ClaimName() string

func (AuthTime) Int64

func (c AuthTime) Int64() int64

func (AuthTime) MarshalJSON

func (c AuthTime) MarshalJSON() ([]byte, error)

func (*AuthTime) UnmarshalJSON

func (c *AuthTime) UnmarshalJSON(data []byte) error

type Azp

type Azp string

Azp is the authorized party - the party to which the token was issued.

func NewAzp

func NewAzp(s string) *Azp

func (Azp) ClaimName

func (c Azp) ClaimName() string

type Birthdate

type Birthdate struct {
	Year       uint
	Month      uint
	DayOfMonth uint
}

Birthdate is End-User's birthday, represented as an ISO 8601:2004 YYYY-MM-DD format. The year MAY be 0000, indicating that it is omitted. To represent only the year, YYYY format is allowed. Note that depending on the underlying platform's date related function, providing just year can result in varying month and day, so the implementers need to take this factor into account to correctly process the dates.

func NewBirthdate

func NewBirthdate(y, m, d uint) (*Birthdate, error)

func NewBirthdateFromStr

func NewBirthdateFromStr(s string) (*Birthdate, error)

func NewBirthdateOnlyYear

func NewBirthdateOnlyYear(y uint) (*Birthdate, error)

func (Birthdate) ClaimName

func (c Birthdate) ClaimName() string

func (Birthdate) MarshalJSON

func (c Birthdate) MarshalJSON() ([]byte, error)

func (Birthdate) String

func (c Birthdate) String() string

type Claim

type Claim = claim.Claim

type Claims

type Claims claim.Claims

func ClaimsFromEncryptedJWT

func ClaimsFromEncryptedJWT(jwt string, keychain jwt.Keychain) (Claims, error)

func ClaimsFromEncryptedJWTWithRegistry

func ClaimsFromEncryptedJWTWithRegistry(
	jwt string,
	keychain jwt.Keychain,
	registry Registrar,
) (Claims, error)

func ClaimsFromJWT

func ClaimsFromJWT(jwt string, keychain jwt.Keychain) (Claims, error)

func ClaimsFromJWTWithRegistry

func ClaimsFromJWTWithRegistry(
	jwt string,
	keychain jwt.Keychain,
	registry Registrar,
) (Claims, error)

func ClaimsFromSignedJWT

func ClaimsFromSignedJWT(jwt string, keychain jwt.PublicKeychain) (Claims, error)

func ClaimsFromSignedJWTWithRegistry

func ClaimsFromSignedJWTWithRegistry(
	jwt string,
	keychain jwt.PublicKeychain,
	registry Registrar,
) (Claims, error)

func NewClaims

func NewClaims() Claims

func UnsafeDecodeClaimsFromJWT

func UnsafeDecodeClaimsFromJWT(jwt string) (Claims, error)

func UnsafeDecodeClaimsFromJWTWithRegistry

func UnsafeDecodeClaimsFromJWTWithRegistry(jwt string, registry Registrar) (Claims, error)

func (Claims) Clone

func (c Claims) Clone() Claims

Clone clones the claims bag.

func (Claims) EncryptJWT

func (c Claims) EncryptJWT(key jwt.PublicEncryptionKey, encryption jose.ContentEncryption) (string, error)

func (Claims) MarshalJSON

func (c Claims) MarshalJSON() ([]byte, error)

func (Claims) Merge

func (c Claims) Merge(claims Claims) Claims

Merge adds all values from another claims bag.

func (Claims) SignJWT

func (c Claims) SignJWT(key jwt.PrivateSigningKey) (string, error)

func (*Claims) UnmarshalJSON

func (c *Claims) UnmarshalJSON(data []byte) error

func (Claims) With

func (c Claims) With(claim Claim) Claims

type Email

type Email string

Email is URL of the End-User's email page. The contents of this Web page SHOULD be about the End-User.

func NewEmail

func NewEmail(s string) (*Email, error)

func (Email) ClaimName

func (c Email) ClaimName() string

type EmailVerified

type EmailVerified bool

EmailVerified represents End-User at the time the verification was performed. The means by which an e-mail address is verified is context-specific, and dependent upon the trust framework or contractual agreements within which the parties are operating.

func NewEmailVerified

func NewEmailVerified(b bool) (*EmailVerified, error)

func (EmailVerified) ClaimName

func (c EmailVerified) ClaimName() string

type Exp

type Exp = claim.Exp

type FamilyName

type FamilyName string

FamilyName is surname(s) or last name(s) of the End-User. Note that in some cultures, people can have multiple family names or no family name; all can be present, with the names being separated by space characters.

func NewFamilyName

func NewFamilyName(s string) (*FamilyName, error)

func (FamilyName) ClaimName

func (c FamilyName) ClaimName() string

type Gender

type Gender string

Gender is End-User's gender. Values defined by this specification are female and male. Other values MAY be used when neither of the defined values are applicable.

const (
	GenderMale   Gender = "male"
	GenderFemale Gender = "female"
)

func NewGender

func NewGender(s string) (*Gender, error)

func (Gender) ClaimName

func (c Gender) ClaimName() string

type GivenName

type GivenName string

GivenName is given name(s) or first name(s) of the End-User. Note that in some cultures, people can have multiple given names; all can be present, with the names being separated by space characters.

func NewGivenName

func NewGivenName(s string) (*GivenName, error)

func (GivenName) ClaimName

func (c GivenName) ClaimName() string

type Iat

type Iat = claim.Iat

type Iss

type Iss url.URL

Iss is the identifier for the issuer.

func IssFromStr

func IssFromStr(s string) (*Iss, error)

func NewIss

func NewIss(u url.URL) (*Iss, error)

func (Iss) ClaimName

func (c Iss) ClaimName() string

func (Iss) MarshalJSON

func (c Iss) MarshalJSON() ([]byte, error)

func (Iss) String

func (c Iss) String() string

func (*Iss) UnmarshalJSON

func (c *Iss) UnmarshalJSON(data []byte) error

type Locale

type Locale string

Locale is End-User's locale, represented as a BCP47 language tag. This is typically an ISO 639-1 Alpha-2 language code in lowercase and an ISO 3166-1 Alpha-2 country code in uppercase, separated by a dash. For example, en-US or fr-CA. As a compatibility note, some implementations have used an underscore as the separator rather than a dash, for example, en_US; Relying Parties MAY choose to accept this locale syntax as well.

func NewLocale

func NewLocale(s string) (*Locale, error)

func (Locale) ClaimName

func (c Locale) ClaimName() string

type LocalizedClaim

type LocalizedClaim[T claim.Claim] struct {
	Claim  T
	Locale string
}

func (LocalizedClaim[T]) ClaimName

func (c LocalizedClaim[T]) ClaimName() string

func (LocalizedClaim[T]) MarshalJSON

func (c LocalizedClaim[T]) MarshalJSON() ([]byte, error)

func (*LocalizedClaim[T]) UnmarshalJSON

func (c *LocalizedClaim[T]) UnmarshalJSON(data []byte) error

type MiddleName

type MiddleName string

MiddleName is middle name(s) of the End-User. Note that in some cultures, people can have multiple middle names; all can be present, with the names being separated by space characters. Also note that in some cultures, middle names are not used.

func NewMiddleName

func NewMiddleName(s string) (*MiddleName, error)

func (MiddleName) ClaimName

func (c MiddleName) ClaimName() string

type Name

type Name string

Name is End-User's full name in displayable form including all name parts, possibly including titles and suffixes, ordered according to the End-User's locale and preferences.

func NewName

func NewName(s string) (*Name, error)

func (Name) ClaimName

func (c Name) ClaimName() string

type Nickname

type Nickname string

Nickname is casual name of the End-User that may or may not be the same as the given_name. For instance, a nickname value of Mike might be returned alongside a given_name value of Michael.

func NewNickname

func NewNickname(s string) (*Nickname, error)

func (Nickname) ClaimName

func (c Nickname) ClaimName() string

type Nonce

type Nonce string

Nonce is a string value used to associate a client session with the token, and to mitigate replay attacks.

func NewNonce

func NewNonce(s string) *Nonce

func (Nonce) ClaimName

func (c Nonce) ClaimName() string

type PhoneNumber

type PhoneNumber string

PhoneNumber is End-User's preferred telephone number. E.164 is RECOMMENDED as the format of this Claim, for example, +1 (425) 555-1212 or +56 (2) 687 2400. If the phone number contains an extension, it is RECOMMENDED that the extension be represented using the RFC 3966 [RFC3966] extension syntax, for example, +1 (604) 555-1234;ext=5678.

func NewPhoneNumber

func NewPhoneNumber(s string) (*PhoneNumber, error)

func (PhoneNumber) ClaimName

func (c PhoneNumber) ClaimName() string

type PhoneNumberVerified

type PhoneNumberVerified bool

PhoneNumberVerified is true if the End-User's phone number has been verified; otherwise false. When this Claim Value is true, this means that the OP took affirmative steps to ensure that this phone number was controlled by the End-User at the time the verification was performed. The means by which a phone number is verified is context-specific, and dependent upon the trust framework or contractual agreements within which the parties are operating. When true, the phone_number Claim MUST be in E.164 format and any extensions MUST be represented in RFC 3966 format.

func NewPhoneNumberVerified

func NewPhoneNumberVerified(b bool) (*PhoneNumberVerified, error)

func (PhoneNumberVerified) ClaimName

func (c PhoneNumberVerified) ClaimName() string

type Picture

type Picture url.URL

Picture is URL of the End-User's profile picture. This URL MUST refer to an image file (for example, a PNG, JPEG, or GIF image file), rather than to a Web page containing an image. Note that this URL SHOULD specifically reference a profile photo of the End-User suitable for displaying when describing the End-User, rather than an arbitrary photo taken by the End-User.

func NewPicture

func NewPicture(u url.URL) (*Picture, error)

func PictureFromStr

func PictureFromStr(s string) (*Picture, error)

func (Picture) ClaimName

func (c Picture) ClaimName() string

func (Picture) MarshalJSON

func (c Picture) MarshalJSON() ([]byte, error)

func (Picture) String

func (c Picture) String() string

func (*Picture) UnmarshalJSON

func (c *Picture) UnmarshalJSON(data []byte) error

type PreferredUsername

type PreferredUsername string

PreferredUsername is shorthand name by which the End-User wishes to be referred to at the RP, such as janedoe or j.doe. This value MAY be any valid JSON string including special characters such as @, /, or whitespace. The RP MUST NOT rely upon this value being unique, as discussed in Section 5.7.

func NewPreferredUsername

func NewPreferredUsername(s string) (*PreferredUsername, error)

func (PreferredUsername) ClaimName

func (c PreferredUsername) ClaimName() string

type Profile

type Profile url.URL

Profile is URL of the End-User's profile page. The contents of this Web page SHOULD be about the End-User.

func NewProfile

func NewProfile(u url.URL) (*Profile, error)

func ProfileFromStr

func ProfileFromStr(s string) (*Profile, error)

func (Profile) ClaimName

func (c Profile) ClaimName() string

func (Profile) MarshalJSON

func (c Profile) MarshalJSON() ([]byte, error)

func (Profile) String

func (c Profile) String() string

func (*Profile) UnmarshalJSON

func (c *Profile) UnmarshalJSON(data []byte) error

type Registrar

type Registrar = claim.Registrar

type Sub

type Sub string

Sub is the subject identifier.

func NewSub

func NewSub(s string) (*Sub, error)

func (Sub) ClaimName

func (c Sub) ClaimName() string

type UpdatedAt

type UpdatedAt time.Time

UpdatedAt is time the End-User's information was last updated. Its value is a JSON number representing the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date/time.

func NewUpdatedAt

func NewUpdatedAt(t time.Time) (*UpdatedAt, error)

func UpdatedAtFromInt64

func UpdatedAtFromInt64(i int64) (*UpdatedAt, error)

func (UpdatedAt) ClaimName

func (c UpdatedAt) ClaimName() string

func (UpdatedAt) Int64

func (c UpdatedAt) Int64() int64

func (UpdatedAt) MarshalJSON

func (c UpdatedAt) MarshalJSON() ([]byte, error)

func (*UpdatedAt) UnmarshalJSON

func (c *UpdatedAt) UnmarshalJSON(data []byte) error

type Website

type Website url.URL

Website is URL of the End-User's Web page or blog. This Web page SHOULD contain information published by the End-User or an organization that the End-User is affiliated with.

func NewWebsite

func NewWebsite(u url.URL) (*Website, error)

func WebsiteFromStr

func WebsiteFromStr(s string) (*Website, error)

func (Website) ClaimName

func (c Website) ClaimName() string

func (Website) MarshalJSON

func (c Website) MarshalJSON() ([]byte, error)

func (Website) String

func (c Website) String() string

func (*Website) UnmarshalJSON

func (c *Website) UnmarshalJSON(data []byte) error

type Zoneinfo

type Zoneinfo string

Zoneinfo is string from zoneinfo time zone database representing the End-User's time zone. For example, Europe/Paris or America/Los_Angeles.

func NewZoneinfo

func NewZoneinfo(s string) (*Zoneinfo, error)

func (Zoneinfo) ClaimName

func (c Zoneinfo) ClaimName() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL