Administrator

How do I enable a user to create their own account?

Follow
Ryan Richins
  • Agilix team member

Buzz allows users to self-register their accounts and be automatically enrolled into defined courses

Beta

  • As it is currently in beta, this feature and any associated data may change or be removed altogether without notice at any time.

In order to set this up, you need to edit your Domain Settings and create a token using the Agilix API. When enabled, this feature allows users to create an account from Buzz's sign in screen by providing first and last name, email, password, and a code (the token you create).

Edit Domain Settings

  1. Open Settings in the Domain toolbar.
Edit Domain Settings
  1. Select Integrations and check the Allow users to create their own accounts box under Authentication. This option is not available with single-sign on configurations.
  2. Click Save.

Create the token

To create a token (code) for the user to use upon registration:

  1. Use the CreateCommandTokens API command to update your domain.
  2. Choose your preferred registration action:
    • Create user and enroll into defined course(s)
<requests>
  <commandtoken scopeentityid="//userspace" description="Create account and enroll into multiple courses" allowunauthenticatedredemption="true" codelength="6">
    <action>
    <batch>
      <request cmd="createusers2">
        <requests>
          <user username="$email$" password="$password$" firstname="$first$" lastname="$last$" email="$email$" domainid="//userspace"></user>
        </requests>
      </request>
      <request cmd="createenrollments" disallowduplicates="true">
        <requests>
          <enrollment domainid="//userspace" entityid="courseid" userid="//userspace//$email$" flags="131073" status="1" schema="2"/>
        </requests>
      </request>
    </batch>
    </action>
  </commandtoken>
</requests>
  • Note: Replace each userspace value (login prefix for the domain the user will register at) and courseid value (ID of the course) the user is to be enrolled in. Also, you can copy the <enrollment> element to enroll the user into multiple courses. Simply have a unique courseid value for each <enrollment>.
  • Create user only
<requests>
  <commandtoken scopeentityid="//userspace" description="Create account" allowunauthenticatedredemption="true" codelength="6">
    <action>
      <request cmd="createusers2">
        <requests>
          <user username="$email$" password="$password$" firstname="$first$" lastname="$last$" email="$email$" domainid="//userspace"></user>
        </requests>
      </request>
    </action>
  </commandtoken>
</requests>
  • Note: Replace the userspace value (login prefix for the domain the user will register at).
  1. Post the API command.
    • Note: Copy the commandtoken code value.
  2. Share the URL for the login page and the code that the user is supposed to use upon registration.

Comments (1)

Sort by
Aileen Sweeney

Where do we find the sample for ListCommandTokens? We can't find in any of the listed commandes in the API Command Index?

 We used trial and error and finally figure it out.

Method =Post    Accepts:XML

Query String cmd=CreateCommandTokens

Content-Type   text/xml

 

Post Data

<requests>

  <commandtoken scopeentityid="//(we entered our domain login prefix" description="Create account" allowunauthenticatedredemption="true" codelength="6">

    <action>

      <request cmd="createusers2">

        <requests>

          <user username="$email$" password="$password$" firstname="$first$" lastname="$last$" email="$email$" domainid="(we entered our id number)"></user>

        </requests>

      </request>

    </action>

  </commandtoken>

</requests>

Please sign in to leave a comment.