NAME

Langertha::Manifest::Auth - One auth mechanism of a provider manifest (type only, never a secret)

VERSION

version 0.503

SYNOPSIS

my $auth = Langertha::Manifest::Auth->new( id => 'api', type => 'api_key' );

DESCRIPTION

An auth entry of a Langertha::Manifest. It names a mechanism only. It never holds a key, a secret path or an environment-variable name: which local credential feeds the mechanism is the client's decision. The header/query contract (Authorization: Bearer, x-api-key, ?key=, …) belongs to the endpoint's dialect, not to this entry.

id

Local id, unique within the manifest; endpoints point at it with auth_ref.

type

Mechanism token (see "known_types"). A pattern-valid but unknown type is accepted; "is_known_type" tells a client whether it can serve it.

known_types

The v1 auth-type vocabulary: api_key.

is_known_type

True when "type" is in the v1 vocabulary.

from_hash

Builds an auth entry from its JSON object form, rejecting unknown and forbidden fields (a key, token, secret path or env-var name is forbidden).

to_hash

Returns the JSON object form.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.