Authentication overview

Jobs2Careers, acquired by Talroo in 2017, integrates its programmatic job advertising and candidate sourcing capabilities within the broader Talroo platform. Consequently, authentication for Jobs2Careers's services is managed through the Talroo API infrastructure. This system primarily utilizes API keys to secure access to endpoints, enabling partners and developers to manage job postings, optimize campaigns, and retrieve performance data. The authentication process is designed to ensure that only authorized applications can interact with the platform, protecting both client data and system integrity.

API keys serve as a simple yet effective method for identifying the calling application and associating it with a specific account and its permissions. When making an API request, the provided key allows the Talroo system to verify the sender's identity and authorize the requested action based on predefined access levels. This approach facilitates straightforward integration while maintaining necessary security protocols for programmatic job distribution and acquisition services.

Supported authentication methods

The Talroo platform, which encompasses Jobs2Careers's functionality, primarily supports API key authentication for its programmatic interfaces. This method involves generating a unique alphanumeric string that acts as a credential to authenticate requests. While API keys are the default and most common method for server-to-server communication, specific integrations or partner requirements might involve additional security layers or variations in key management.

The table below outlines the primary authentication method and its characteristics:

Method When to Use Security Level
API Key Programmatic access, server-to-server integrations, automated job feeds, campaign management. Standard. Requires secure storage and transmission (HTTPS) to prevent compromise.

API keys are generally suitable for applications where the client is a trusted server-side component. For more complex scenarios involving user delegation or third-party access without sharing direct credentials, platforms often implement OAuth, a framework for delegated authorization. However, for direct programmatic interaction with the Talroo platform, API keys are the established mechanism.

Getting your credentials

To obtain the necessary API credentials for accessing Jobs2Careers functionality via the Talroo platform, developers and partners typically follow these steps:

  1. Partner Onboarding: Begin by establishing a partnership with Talroo. This usually involves contacting their sales or partnership team to discuss integration requirements and access levels.
  2. Access to Talroo Partner Portal: Once onboarded, you will gain access to the dedicated Talroo Partner Portal or developer dashboard. This portal serves as the central hub for managing your account, integrations, and credentials.
  3. API Key Generation: Within the Partner Portal, navigate to the API settings or developer section. Here, you will find options to generate new API keys or view existing ones. The process typically involves selecting an application or integration profile and then generating a key associated with that profile.
  4. Permissioning: API keys are often associated with specific permissions or scopes that dictate what actions the key holder can perform. Ensure that the generated key has the necessary permissions to execute the required API calls (e.g., posting jobs, retrieving analytics).
  5. Secure Storage: Upon generation, the API key should be immediately stored securely. Treat API keys as sensitive credentials, similar to passwords, and avoid embedding them directly in client-side code or public repositories.

If you encounter any issues or have specific requirements not covered by the standard process, it is recommended to consult the official Talroo support documentation or contact their developer support team directly for guidance on credential acquisition and management.

Authenticated request example

When making an API call to the Talroo platform (integrating Jobs2Careers services), your API key typically needs to be included in the request headers or as a query parameter. The specific method depends on the API's design, but common practice involves using an Authorization header. Below is a conceptual example using curl, demonstrating how an API key might be passed in an HTTP header:

curl -X POST \
  'https://api.talroo.com/v1/jobs' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "title": "Software Engineer",
    "company": "Example Corp",
    "location": "Austin, TX",
    "description": "Join our team..."
  }'

In this example:

  • YOUR_API_KEY should be replaced with the actual API key you obtained from the Talroo Partner Portal.
  • The Authorization: Bearer header is a common convention for passing API keys or OAuth access tokens. Some APIs might use a custom header like X-API-KEY instead. Always refer to the specific API documentation for the exact header or parameter name.
  • The request body contains the data payload, in this case, details for a new job posting in JSON format.

For client libraries in various programming languages, the method of adding headers will vary. For instance, in Python with the requests library, you might do:

import requests

api_key = "YOUR_API_KEY"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}
job_data = {
    "title": "Software Engineer",
    "company": "Example Corp",
    "location": "Austin, TX",
    "description": "Join our team..."
}

response = requests.post("https://api.talroo.com/v1/jobs", headers=headers, json=job_data)

print(response.json())

Always consult the Talroo API documentation for the most accurate and up-to-date instructions on constructing authenticated requests, including specific endpoint URLs, required headers, and expected data formats.

Security best practices

Securing your API keys and ensuring the integrity of your integrations with Jobs2Careers (via Talroo) is crucial. Adhering to fundamental security best practices helps prevent unauthorized access and data breaches.

  • Treat API Keys as Passwords: API keys grant access to your account and data. Store them with the same level of security as you would sensitive credentials like passwords. Never hardcode them directly into client-side code, commit them to public version control systems (e.g., GitHub), or expose them in client-facing applications.
  • Use Environment Variables: For server-side applications, store API keys in environment variables rather than directly in your codebase. This allows you to manage keys outside of your application's source code and easily rotate them without code changes.
  • Secure Transmission (HTTPS/TLS): Always ensure that all API requests are made over HTTPS (TLS). This encrypts the communication between your application and the Talroo API, preventing eavesdropping and protecting your API key and data in transit. Public APIs almost universally enforce HTTPS.
  • Implement IP Whitelisting: If the Talroo API supports it, configure IP whitelisting for your API keys. This restricts API calls to only originate from a predefined list of trusted IP addresses, adding an extra layer of security by blocking requests from unknown sources.
  • Implement Least Privilege: Request and use API keys that have only the minimum necessary permissions to perform their intended function. If an API key is compromised, the damage will be limited to the actions it is authorized to perform.
  • Regular Key Rotation: Periodically rotate your API keys. This practice minimizes the window of vulnerability if a key is ever compromised. The Talroo Partner Portal should provide mechanisms for generating new keys and deactivating old ones.
  • Monitor API Usage: Regularly monitor your API usage and logs for any unusual activity. Spikes in requests, calls from unexpected locations, or attempts to access unauthorized endpoints could indicate a compromised key.
  • Error Handling: Implement robust error handling in your application to gracefully manage authentication failures. Avoid leaking sensitive information (like the exact reason for authentication failure if it reveals key details) in error messages that might be exposed to end-users.

By following these best practices, you can significantly enhance the security posture of your Jobs2Careers integrations and protect your programmatic job advertising operations.