The Ping Proxy feature offers an alternative method for collecting usage statistics from client devices, without the need for direct communication with Microblink's services. This approach is designed to suit clients who prefer or require that data be routed through a central point within their controlled environment (such as a DMZ) before being forwarded to Microblink. In order to use this feature, you need to have a valid Microblink license that includes Ping Proxy usage rights.
To utilize the Ping Proxy for usage data collection, your Microblink SDK must include the necessary licensing rights. This solution employs HTTPS for secure communication between the client device and the Ping Proxy, ensuring that HTTP without SSL/TLS is not used.
For ease of deployment, Docker Compose is the recommended method to run this Docker image:
Download docker-compose.yml from [here](link na docker-compose)
Run docker-compose up -d
The Png Proxy service will be accessible at the endpoint http://localhost:8080
Run the following Docker command to start the Ping Proxy service:
`docker run -p 8080:8080 microblink/ping-proxy`
Note: The above command starts the service accessible via http://localhost:8080â for local development. For production and test environments, ensure HTTPS is configured and enabled.
For optimal performance, (e.g., 50 requests/second), we recommend the following settings:
CPU: 1 core Memory: 2 GB
Customize your setup with these environment variables:
CLIENT_SERVICE_URL - Endpoint for clients to consume usage statistics being forwarded to Microblinkâs servicesSSL_ENABLED - Whether SSL is enabled.SSL_KEY_STORE_PATH - SSL key store path.SSL_KEY_STORE_PASSWORD - SSL key store password.SSL_KEY_STORE_TYPE - SSL key store type.SSL_KEY_STORE_PROVIDER - SSL key store provider nameSSL_KEY_PASSWORD - SSL key password.SSL_KEY_ALIAS - SSL key alias.ALLOW_CORS - Whether to enable CORS. Default is true.ALLOWED_METHODS - CORS allowed methods. Default is 'GET,POST,OPTIONS'.ALLOWED_ORIGINS - CORS allowed origins. Empty value means all origins are allowed.LOCALHOST_PASS_THROUGH - Sets whether localhost pass-through is enabled. Default value false. Setting this to true will allow requests to be made to localhost from any origin.Always enable SSL in all environments to ensure data safety. Regularly update your Docker images to incorporate the latest security patches. Use secure passwords and manage SSL certificates carefully to prevent unauthorized access. The client is responsible for implementing measures to ensure the system's safety and its ability to scale, crucial for consistent service performance and reliability.
For further information and support, refer to the following resources:
Microblink Android documentation
Microblink iOS documentation
Microblink website
SSL Setup Issues: Ensure your SSL certificates are valid and properly configured. Docker-related errors: Verify that Docker is correctly installed and that you have sufficient permissions to execute Docker commands. Network Configuration for Communication: It's critical to configure your network to allow communication with https://ping.microblink.comâ . Ensure your firewall and network settings permit outbound HTTPS requests to this URL.
For assistance or questions regarding specific integration scenarios not covered in this documentation, please contact our support team at [email protected]â for a prompt response.
Content type
Image
Digest
sha256:e03cee978âĤ
Size
35.5 MB
Last updated
over 2 years ago
docker pull microblink/ping-proxy