Authen...::Clear(3pm)

πŸ’– Authen::Passphrase::Clear πŸ’–

okay bestie, so this is the manual page for Authen::Passphrase::Clear, from the User Contributed Perl Documentation section of the perl manpages (it's a 3pm page, if you're keeping score). And the vibe is... well. It stores passphrases in cleartext. Yes really. We'll get there. 🫢


✨ NAME ✨

Authen::Passphrase::Clear β€” cleartext passphrases πŸ’…


🌸 SYNOPSIS 🌸

use Authen::Passphrase::Clear;

$ppr = Authen::Passphrase::Clear->new("passphrase");

if($ppr->match($passphrase)) { ...

$passphrase = $ppr->passphrase;

$userPassword = $ppr->as_rfc2307;

πŸ¦‹ DESCRIPTION πŸ¦‹

So, an object of this class is a passphrase recogniser that accepts one specific passphrase β€” the one it already knows. That's it. That's the whole personality.

It's a subclass of Authen::Passphrase, and this doc just assumes you've already read up on that class, because the lore runs deep. πŸ“š

⚠️ WARNING ⚠️ Storing a passphrase in cleartext, which is literally what this class does, is a very bad idea. Like, no shade, but it means anyone who sees the passphrase file immediately knows all the passphrases. Instantly. Zero effort. Do not use this unless you genuinely, truly, for-real know what you're doing. 😭

πŸŽ€ CONSTRUCTORS πŸŽ€

  • Authen::Passphrase::Clear->new(PASSPHRASE) β€” returns a passphrase recogniser object that stores the passphrase you handed it in cleartext, and accepts only that passphrase. One passphrase, one bestie, no exceptions. ✨
  • Authen::Passphrase::Clear->from_rfc2307(USERPASSWORD) β€” builds a cleartext passphrase recogniser out of the RFC2307 encoding you supply 🧚. The string has to start with "{CLEARTEXT}" (case insensitive, we're flexible like that πŸ’…) followed by the passphrase itself.

πŸ‘‘ METHODS πŸ‘‘

  • $ppr->match(PASSPHRASE)
  • $ppr->passphrase
  • $ppr->as_rfc2307

These are all part of the standard Authen::Passphrase interface, so they're just doing their regular duties. And the passphrase method? It trivially works. Of course it does. It knows the passphrase. It is the passphrase. main character energy, honestly. πŸ‘‘


🌈 SEE ALSO 🌈

  • Authen::Passphrase

πŸ’œ AUTHOR πŸ’œ

Andrew Main (Zefram) <zefram@fysh.org>


Copyright (C) 2006, 2007, 2009, 2010, 2012 Andrew Main (Zefram) <zefram@fysh.org>


πŸ’… LICENSE πŸ’…

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay. ✨


this chapter of the lore was brought to you by perl v5.40.1, dated 2026-05-06 πŸŽ€ β€” ily, go read the Authen::Passphrase docs before you do anything chaotic πŸ’–

πŸ“¦ where this page comes from