Authentication methods via REST API
To enable administrators more finite insight into usage information Language Weaver provides two authentication methods via the REST API: Client ID with Secret AND Username with Password.
Both authentication methods are compliant with OAuth2 industry standards. Using one of the two authentication options or both depends on the workflow that you are integrating Machine Translation (MT) into.
Administrators can view and filter usage reports for specific Usernames or Client IDs, to understand how MT is used within their organization.
Recommendations for authenticating with Client ID and Secret
General rule: RWS recommends that ALL external clients should use Client ID and Secret credentials. Username and Password authentication should be used in exceptional cases.
Use case 1: Authenticate with Client ID and Secret if you have machine-to-machine workflows where translations are requested as part of an automated workflow that is not triggered by a specific use request.
Example 1: A typical machine-to-machine workflow would be a social media monitoring system passing content to RWS Machine Translation in an ongoing manner.
Use case 2: Authenticate with Client ID and Secret if you have project workflows where translations are requested as part of an automated step in a larger project workflow.
Example 2: A typical project workflow would be a localization project where content for translation goes through a translation management system and gets pre-populated with RWS Machine Translation before the content is passed on to translators.
Recommendations for authenticating with Username and Password
General rule: RWS recommends that ALL external clients should use Client ID and Secret credentials. Username and Password authentication should be used in exceptional cases.
Use case: Authenticate with Username and Password if you have a desktop application where translation requests are triggered by a specific user request.
Example: Username and Password can be used when integrating MT with desktop productivity tools: email clients, spreadsheets, text editors.