Preparation of Profit Connectors (AFAS Online)

You create a test user to build and test connectors.

Note:

From the moment you start using the connectors in your production environment, authentication is carried out using tokens (instead of user name/password). For this you need to configure App connector.

Contents

Add a connector user

You add the connector user.

To add a connector user:

  1. Start Profit.
  2. Log in to the environment.
  3. Go to: General / Management / Authorisation tool.
  4. Go to: User / New system user.

    App_Conn GS Lokaal gebruiker toevoegen en autoriseren - menu

  5. Enter the user name in the User field.

  6. Enter the description.
  7. Enter the password.

    The connector user must always have a strong password, even if you are not using this functionality.

  8. Click on: Next.
  9. Select the Connector check box.

    If the user also needs access to other components, select the check boxes for those as well. Select the Command line check box if the connector is called from the Command Line Utility.

    App_Conn GS Lokaal gebruiker toevoegen en autoriseren - menu

  10. Click on: Finish

Authorise a connector user

GetConnectors, reports and analyses are definitions. You can authorise these separately. If you use definition authorisation, you must perform the below procedure.

This procedures enable all authorisation filters for the connector user. Its gives the connector user access to all definitions (and consequently to analyses, reports, etc). You can limit the access of the connector user by setting and authorising the filters.

To authorise a connector user:

  1. Go to the tab: User maintenance.
  2. Select the connector user.
  3. Go to the tab: Authorisation.
  4. Go to: General / Management / Definition / Filters.
  5. Select Filter active.

    This authorises all filters for this user. If this is not what you want, only activate the relevant filters.

    You must authorise these filters because they apply to views with definitions, including the views with GetConnectors. The filter authorisation determines the connectors that the connector user can run.

    If the Filters option is not available, you must first configure the filters.

    App_Conn GS Lokaal gebruiker toevoegen en autoriseren - menu

  6. If you expand the folders with filters, you can see that they are authorised.

    App_Conn GS Lokaal gebruiker toevoegen en autoriseren - menu

  7. Close the Authorisation tool. You do not have to log on again.

Restrict the authorisation to GetConnectors

You determine that the connector user is allowed to run GetConnectors, but should not have access to reports, analyses, etc. This prevents the connector user from running reports and analyses from the command line. After all, this user can only run GetConnectors.

Connector user is only allowed to run GetConnectors:

  1. Go to: General / Management / Authorisation tool.
  2. Go to: Extra / Data filter maintenance (or click on ).

    App_Autorisatiefilters toevoegen (menu)

  3. Select the filter type General - Execute definition (report, analysis, document, etc.).

  4. Click on: Add.
  5. Enter the description.
  6. Select According to filter.
  7. Record a filter on the GetConnector definition type (code 8).

    App_Conn GS Lokaal gebruiker toevoegen en autoriseren - menu

  8. Click on: OK.
  9. Click on: Close.
  10. Go to the tab: User maintenance.
  11. Select the connector user.
  12. Go to the tab: Authorisation.
  13. Select the filter.
  14. Select Filter active.

Directly to

  1. Build and test connectors
  2. Preparations
  3. Configure the App Connector
  4. Build and test a GetConnector
  5. Build and test an UpdateConnector
  6. Error message logging