The following are the prerequisites to use FilesAnywhere digitally signed API in your API consumer application:
1. Obtain the new, or use any existing, client authentication certificate issued to your organization by a trusted certificate authority (CA).
Note: The server will perform the required authentication and authorization process against your API request using the client authentication certificate passed along with your API request.
2. Contact FilesAnywhere Support with your Client ID and Certificate Thumbprint details which you want to use for calling the FilesAnywhere digitally signed API.
3. Once your Client ID and Certificate Thumbprint mapping is completed after necessary approval process; you can use the FilesAnywhere digitally signed API in your development environment.
Guidelines for client authentication certificate
How to obtain a new certificate from a trusted certificate authority (CA)
Please refer to this link from digicert to learn more about client authentication certificates and how to obtain one. You can use client authentication certificates issued by any other trusted certificate authorities i.e. Comodo, IdenTrust, Symantec, GoDaddy, GlobalSign, Verisign etc
How to retrieve a thumbprint of existing certificate issued by trusted certificate authority (CA)
Note: Below steps are applicable for all versions of Windows 7, 8, 10 and Windows Server 2012 operating systems.
- Open a Command Prompt window.
- Type mmc and press the ENTER key.
Note: In order to view certificates in the local machine, you must be in the Administrator role.
- On the File menu, click Add/Remove Snap In.
- In the Add Standalone Snap-in dialog box, select Certificates.
- Click Add.
- In the Certificates snap-in dialog box, select Computer account (optionally, you can select My User account or Service account) and click Next. If you are not an administrator of the computer, you can manage certificates only for your user account.
- In the Select Computer dialog box, click Finish.
- On the Add/Remove Snap-in dialog box, click OK.
- In the Console Root window, click Certificates (Local Computer) to view the certificate stores for the computer.
- Click the Personal folder to expand it.
- Click the Certificates folder to expand it.
- In the list of certificates, note the Intended Purposes heading. Find a certificate that lists Client Authentication or Server Authentication as an intended purpose(s).
- Double-click the certificate.
- In the Certificate dialog box, click the Details tab.
- Scroll through the list of fields and click Thumbprint.
- Copy the hexadecimal characters from the box.
- Remove the spaces between the hexadecimal numbers. For example, the thumbprint is "a9 09 50 2d d8 2a e4 14 33 e6 f8 38 86 b0 0d 42 77 a3 2a 7b" then it should be specified and share with the FilesAnywhere support team as "a909502dd82ae41433e6f83886b00d4277a32a7b" as a certificate thumbprint along with your client ID.
- Make sure that you are using the same certificate and client id combination while calling the FilesAnywhere digitally signed API methods.
You can refer to the FilesAnywhere API documentation from the FilesAnywhere site. Go to the API Specifications tab for more details on how to call FilesAnywhere digitally signed API methods.
Still Have Questions?
If you have further questions, please feel free to contact us and we will be happy to assist you.