res_pjsip_phoneprov_provider

Since 12.7.0 Module Configuration Found this useful? Upvote it. ×

Module that integrates res_pjsip with res_phoneprov.

Last reviewed 2026-04-14

Description

PJSIP Phoneprov Provider

This module creates the integration between res_pjsip and res_phoneprov.

Each user to be integrated requires a phoneprov section defined in pjsip.conf. Each section identifies the endpoint associated with the user and any other name/value pairs to be passed on to res_phoneprov's template substitution. Only MAC and PROFILE variables are required. Any other variables supplied will be passed through.

Example:

[1000]

type = phoneprovr

endpoint = ep1000

MAC = deadbeef4dad

PROFILE = grandstream2

LINEKEYS = 2

LINE = 1

OTHERVAR = othervalue

The following variables are automatically defined if an endpoint is defined for the user:

  • USERNAME - Source: The user_name defined in the first auth reference in the endpoint.
  • SECRET - Source: The user_pass defined in the first auth reference in the endpoint.
  • CALLERID - Source: The number part of the callerid defined in the endpoint.
  • DISPLAY_NAME - Source: The name part of the callerid defined in the endpoint.
  • LABEL - Source: The id of the phoneprov section.

In addition to the standard variables, the following are also automatically defined:

  • ENDPOINT_ID - Source: The id of the endpoint.
  • TRANSPORT_ID - Source: The id of the transport used by the endpoint.
  • AUTH_ID - Source: The id of the auth used by the endpoint.

All other template substitution variables must be explicitly defined in the phoneprov_default or phoneprov sections.

pjsip.conf

[phoneprov]

Provides variables for each user.

  • type - Must be of type 'phoneprov'.
  • endpoint - The endpoint from which variables will be retrieved.
  • MAC - The mac address for this user. (required)
  • PROFILE - The phoneprov profile to use for this user. (required)
  • * - Other name/value pairs to be passed through for use in templates.
User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.

Moderated before publishing. Email never shown.