0.12.0 • Published 3 years ago

@hallparty/xmpp-sasl v0.12.0

Weekly downloads
-
License
ISC
Repository
github
Last release
3 years ago

SASL

SASL Negotiation for @hallparty/xmpp-client.

Included and enabled in @hallparty/xmpp-client.

Usage

object

const {xmpp} = require('@hallparty/xmpp-client')
const client = xmpp({credentials: {
  username: 'foo',
  password: 'bar'
})

function

Instead, you can provide a function that will be called every time authentication occurs (every (re)connect).

Uses cases:

  • Have the user enter the password every time
  • Do not ask for password before connection is made
  • Debug authentication
  • Using a SASL mechanism with specific requirements
  • Perform an asynchronous operation to get credentials
const { xmpp } = require("@hallparty/xmpp-client");
const client = xmpp({ credentials: authenticate });

async function authenticate(auth, mechanism) {
  console.debug("authenticate", mechanism);
  const credentials = {
    username: await prompt("enter username"),
    password: await prompt("enter password"),
  };
  console.debug("authenticating");
  try {
    await auth(credentials);
    console.debug("authenticated");
  } catch (err) {
    console.error(err);
    throw err;
  }
}

References

RFC 6120 SASL Negotiation