Net::ST...t::Auth(3)

💖 NAME 💖

Okay so bestie, welcome to Net::ST...t::Auth(3) — yes, the User Contributed Perl Documentation girlie — and the module itself is Net::STOMP::Client::Auth. It's literally authentication support for Net::STOMP::Client. That's the name, that's the vibe. 💅

---

🌸 SYNOPSIS 🌸

  use Net::STOMP::Client;
  $stomp = Net::STOMP::Client->new(
      uri  => "stomp://127.0.0.1:61613",
      auth => "plain name=system pass=manager",
  );

---

🦋 DESCRIPTION 🦋

This module handles STOMP authentication. It is used internally by Net::STOMP::Client and should not be directly used elsewhere. Bestie, it's giving internal plumbing — do not poke it directly. 🙈

If the optional Authen::Credential module is available, an additional auth attribute can be given to Net::STOMP::Client's new() method. If the module is not available, the auth attribute cannot be used. No cap. 😭

This attribute can take either a single authentication credential (either as a string or an Authen::Credential object) or multiple credentials (via an array reference). See Authen::Credential for more information about these credentials. ✨

If an X.509 credential is given, it will be used at SSL connection time. If a plain credential is given, it will be used in the CONNECT frame. If needed, both types of credentials could be used for the same STOMP connection. Both? Yes bestie, both. 👑

Using generic authentication credentials is very convenient as they could be passed as command line options to a script:

  # default authentication
  $Option{auth} = "none";
  # get URI & credential from command line
  GetOptions(\%Option,
      "auth=s",
      "uri=s",
      ...
  );
  $stomp = Net::STOMP::Client->new(uri => $Option{uri}, auth => $Option{auth});

---

🌈 SEE ALSO 🌈

• Authen::Credential — the credential bestie 💖
• Net::STOMP::Client — the main character 👑

---

👑 AUTHOR 👑

Lionel Cons <http://cern.ch/lionel.cons>

Copyright (C) CERN 2010-2017

Written by the icon himself — slay. 💅

---

Big kiss, bestie — this is perl v5.32.1, dated 2019-07-26, under Net::ST...t::Auth(3). Mwah 💋✨