External Source Authentication (Self-Managed)

Info

This information is relevant for self-managed integrations. For Textkernel-Managed integrations, please go here.

The list of available external sources can be found here. Below is a list containing all sources (by Searcher ID) and their authentication parameters. These parameters are set via User Management.

Note that authentication parameters are often optional in case they are user-specific. In that case the user will be prompted to enter the credentials in the Source UI.

Authentication Parameters

Searcher ID	Parameters	Required1	Comment
careerbuilder_us			User authenticates using CB SSO
career_structure	username, password	Optional	User's CareerStructure credentials
caterer	username, password	Optional	User's Caterer credentials
cityjobs	username, password	Optional	User's CityJobs credentials
cv_library	username, password	Optional	CV-Library API credentials. Note: those are not user credentials. Users are automatically identified based on their email address.
cwjobs	username, password	Optional	User's CWJobs credentials
dice	client_id, client_secret, username, password	Required / Optional	Dice API keys (company-wide) are required. Dice username and password are optional
dpg			Users are not authenticated, only public profile information is retrieved
efinancialcareers	trusted_account_api_key	Required	eFinancial API key (company-wide)
emedcareers	username, password	Optional	User's eMedCareers credentials
github			Google API keys are preset by Textkernel
indeed			User authenticates using Indeed SSO
job_site	username, password	Optional	User's Jobsite credentials
jobserve	account-number, authorisation-code	Optional	JobServe account number (company-wide) and User's Jobsite password
just_engineers	username, password	Optional	User's JustEngineers Credentials
linkedin			Google API keys are preset by Textkernel
monster	cat	Required	Monster CAT key user-specific or (company-wide)
mocked			No authentication required (test database with example profiles)
reed	username, posting_key	Optional	User's Reed username and Posting Key
resume_library	account_id, account_key	Required	Resume Library account id and key (company-wide)
retail_choice	username, password	Optional	User's RetailChoice credentials
stackoverflow			Google API keys are preset by Textkernel
totaljobs	username, password	Optional	User's Totaljobs credentials
xing	client_id, client_secret	Required	XING API keys (company-wide). Users authenticate with SSO.

• 1: Optional credentials are prompted to the user in the UI if not provided via the user configuration.

Example JSON configuration

This is an example JSON configuration containing all available sources.

"searcherAccess":
  [
    {
      "searcher": "careerbuilder_us"
    },
    {
      "searcher": "career_structure",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "caterer",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "cityjobs",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "cv_library",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "cwjobs",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "dice",
      "client_id": "...",
      "client_secret": "...",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "dpg"
    },
    {
      "searcher": "efinancialcareers",
      "trusted_account_api_key": "..."
    },
    {
      "searcher": "emedcareers",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "github",
      "api_key": "..."
    },
    {
      "searcher": "indeed"
    },
    {
      "searcher": "job_site",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "jobmedic"
    },
    {
      "searcher": "jobserve",
      "account-number": "...",
      "authorisation-code":"..."
    },
    {
      "searcher": "just_engineers",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "linkedin",
      "api_key": "..."
    },
    {
      "searcher": "mocked"
    },
    {
      "searcher": "monster",
      "cat": "cat"
    },
    {
      "searcher": "reed",
      "username": "...",
      "posting_key": "..."
    },
    {
      "searcher": "resume_library",
      "account_id": "...",
      "account_key":"..."
    },
    {
      "searcher": "retail_choice",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "stackoverflow",
      "api_key": "..."
    },
    {
      "searcher": "totaljobs",
      "username": "...",
      "password": "..."
    },
    {
      "searcher": "xing",
      "client_id": "...",
      "client_secret": "..."
    }
  ]