Skip to main content

Kurulum Dökümanı 2.3.1

Install UMS Admin Console Server​

Please run the following command;

docker run -d -p 443:443 --name udentify-admin-console -v /opt/udentify/udentify.properties:/opt/udentify/udentify.properties -v /opt/udentify/udentify.p12:/opt/udentify/udentify.p12 -v /opt/udentify/logback.xml:/opt/udentify/logback.xml -v /opt/udentify/license:/opt/udentify/license registry.fraud.com:443/udentify-rest-admin:latest

Install UMS API Servers​

Please run the following command;

docker run -d -p 443:443 --name udentify-API -v /opt/udentify/udentify.properties:/opt/udentify/udentify.properties -v /opt/udentify/udentify.p12:/opt/udentify/udentify.p12 -v /opt/udentify/logback.xml:/opt/udentify/logback.xml -v /opt/udentify/license:/opt/udentify/license registry.fraud.com:443/udentify-rest:latest

Udentify Face Server Installation​

docker run -d --name ufs --cap-add=SYS_PTRACE --security-opt seccomp=unconfined --runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all -e NVIDIA_DRIVER_CAPABILITIES=all --device /dev/dri -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -p 9001:9001 registry.fraud.com:443/udentify-face-server:2.2

Udentify Liveness Server Installation​

To run the service with HTTP protocol please run the command below

docker run -d --name uls --cap-add=SYS_PTRACE --gpus all --publish 8080:8080 registry.fraud.com:443/udentify-live-server:2.2

To run the service with HTTPS protocol please run the command below

docker run -d --name uls -v /opt/udentify/liveness-ssl-file.pem:/app/liveness-ssl-file.pem -e SERVER_SSL_ENABLED=true  -e SERVER_SSL_KEY_STORE=liveness-ssl-file.pem  --cap-add=SYS_PTRACE --gpus all --publish 8080:8080 registry.fraud.com:443/udentify-live-server:2.2

Info Docker-compose only required for Udentify Vector Engine (Milvus) Server. You don't need to install docker-compose for other servers and services.

mkdir -p /usr/local/lib/docker/cli-plugins

Install Docker Compose

curl https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/lib/docker/cli-plugins

chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

Download the zip file and upload the configuration to your server

Download the configuration file and upload this file to /opt folder on your UMS servers and Vector Engine server udentify.tar.gz

If you are installing Vector Engine Service to a separate server please use this folder;

Warning You can use either volume or mount point options. In this documentation, we will proceed with the “mount point” option. And we are using /opt/udentify path for mounting. You can also change this path as well.

Warning Please create your own server certificate file and upload it to the server as a udentify.p12 file. You can use another file name, but please don’t forget to change the name of the file on the “docker run” command as well, if this is the case.

Installing Udentify Vector Engine (Milvus)​

Create a docker-compose.yml file with your favourite text editor

nano docker-compose.yaml

and paste the content below docker-compose.yaml

docker-compose.yaml
version: '3.5'
 
services:
  etcd:
    container_name: milvus-etcd
    image: registry.fraud.com:443/quay.io/coreos/etcd:v3.5.0
    environment:
      - ETCD_AUTO_COMPACTION_MODE=revision
      - ETCD_AUTO_COMPACTION_RETENTION=1000
      - ETCD_QUOTA_BACKEND_BYTES=4294967296
    volumes:
      - type: bind    
        source: /opt/udentify/milvus/etcd
        target: /etcd 
    command: etcd -advertise-client-urls=http://127.0.0.1:2379 -listen-client-urls http://0.0.0.0:2379 --data-dir /etcd
 
  minio:
    container_name: milvus-minio
    image: registry.fraud.com:443/minio/minio:RELEASE.2020-12-03T00-03-10Z
    environment:
      MINIO_ACCESS_KEY: minioadmin
      MINIO_SECRET_KEY: minioadmin
    volumes:
      - type: bind
        source: /opt/udentify/milvus/minio_data
        target: /minio_data
    command: minio server /minio_data
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
      interval: 30s
      timeout: 20s
      retries: 3
 
  standalone:
    container_name: milvus-standalone
    image: registry.fraud.com:443/milvusdb/milvus:v2.0.2 
    command: ["milvus", "run", "standalone"]
    environment:
      ETCD_ENDPOINTS: etcd:2379
      MINIO_ADDRESS: minio:9000
    volumes:
      - type: bind
        source: /opt/udentify/milvus/milvus_data
        target: /var/lib/milvus
    ports:
      - "19530:19530"
    depends_on:
      - "etcd"
      - "minio"
 
networks:
  default:
    name: milvus

Run the command

/usr/local/lib/docker/cli-plugins/docker-compose -f docker-compose.yaml up -d

Installing UMS Admin Console and UMS API Server​

Use your favourite text editor to create udentify.properties file

nano udentify.properties

Then paste the content below to udentify.properties

udentify.properties
############## General Server Config ##############
server.port=443
server.ssl.enabled=true
server.ssl.key-store=/opt/udentify/<config_me-key-store-name>
server.ssl.key-store-password= <config_me-key-store-pass>
spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB
io.udentify.transaction.timeout=5
io.udentify.transaction.video.conference.timeout=15
 
############## NFC and  OCR Config ##############
 
io.udentify.nfc.locations.server.url=
io.udentify.nfc.locations.folder.root=/opt/udentify/template/
io.udentify.ocr.templates.server.url=
io.udentify.ocr.templates.folder.root=/opt/udentify/template/
spring.resources.static-locations=file:/opt/udentify/static/
io.udentify.nfc.certificate.server.url= https://cc.udentify.io/idchecker/pa
 
#if enabled, logs success client operations as well
io.udentify.client.logging.log.success.operations = true
 
#if enabled, persists success client operations as well
io.udentify.client.logging.persist.success.operations = true
 
############## Udentify Face & Liveness Server Config ##############
io.udentify.face.liveness.server.url=https://<config_me-Face Liveness IP><config_me-Face Liveness PORT>
io.udentify.face.liveness.server.x_api_key=FVrHKPw4iKUllbvKibS19vHPBvayTMr9sm9hHgY1
io.udentify.license.folder.root=/opt/udentify/license/
io.udentify.data.folder.root=/opt/udentify/media
io.udentify.data.folder.blacklist=/opt/udentify/blacklist
io.udentify.data.folder.whitelist=/opt/udentify/whitelist
io.udentify.data.folder.sub=
io.udentify.face.match.host=<config_me-Face Server IP>
io.udentify.face.match.port=9001
io.udentify.face.vector.host=<config_me-Vector Server IP>
io.udentify.face.vector.port=19530
io.udentify.face.delete.photo=false
io.udentify.face.healthcheck.file.path=/opt/udentify/healthcheck.png
io.udentify.face.healthcheck.userid = 1623843142687
io.udentify.face.healthcheck.username =healthchecktestuser
 
############## Thresh Hold Config ##############
 
# sets the min value for face recognition threshold. It fails if the score is under threshold value.
io.udentify.face.match.threshold = 0.35
# sets the min value for face liveness threshold. It fails if the score is under threshold value.
io.udentify.face.liveness.threshold = 0.50
 
# 2.2 Additional Config
io.udentify.transaction.job.update.count=50
io.udentify.face.match.alternative=1
io.udentify.face.vector.enable-backup=true
io.udentify.face.liveness.quality.threshold=0.50
 
# if the following setting is enabled, then the NFC operation must be passed from Active & Passive Authentications in order to get NFC image as reference image in Face Registration. Upload or OCR image gets the priority otherwise.
io.udentify.face.enable.mrtd.authentication.check = false
 
io.udentify.X-Api-Key = zaCELgL.0imfnc8mVLWwsAawjYr4Rx-Af50DDqtlx
 
#### Optional Configurations #####
#io.udentify.face.twilio.account-sid=
#io.udentify.face.twilio.auth-token=
#io.udentify.face.twilio.phone-number=
#io.udentify.ocr.aws.username=
#io.udentify.ocr.aws.access-key-id=
#io.udentify.ocr.aws.secret-access-key=
io.udentify.push.notification.apns.bundle.id=
io.udentify.push.notification.apns.team.id=
io.udentify.push.notification.apns.key.id=
io.udentify.push.notification.apns.signing.key.path=
 
############## FrontEnd - Admin Dashboard ##############
spring.resources.static-locations=file:/opt/udentify/static/
io.udentify.admin-dashboard.appjs=app.d9626483.js
io.udentify.admin-dashboard.initialUrl=<config_me-admin dashboard URL>
io.udentify.admin-dashboard.baseurl=<config_me-admin dashboard URL>
spring.datasource.hikari.connectionTimeout=30000
spring.datasource.hikari.idleTimeout=600000
spring.datasource.hikari.maxLifetime=300000
spring.jpa.hibernate.ddl-auto=validate
spring.jpa.show-sql=true
 
############## MYSQL ##############
#spring.datasource.url=jdbc:mysql://<config_me-db Host>:3306/<config_me-db Name>
#spring.datasource.username=<config_me-db user>
#spring.datasource.password=<config_me-db pass>
#spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#io.udentify.activedialect=MySQL
 
############## ORACLE ##############
#spring.datasource.driver.class=oracle.jdbc.driver.OracleDriver
#spring.datasource.url=jdbc:oracle:thin:@demo.udentify.io:1521:xe
#spring.datasource.username=<config_me-db user>
#spring.datasource.password=<config_me-db pass>
#spring.jpa.properties.hibernate.default_schema=<config_me-Schema Name>
#io.udentify.activedialect=ORA
 
############## MS SQL SERVER ##############
#spring.datasource.url=jdbc:sqlserver://<config_me-db Host>;databaseName=<config_me-db Name>
#spring.datasource.username=<config_me-db user>
#spring.datasource.password=<config_me-db pass>
#spring.datasource.driverclassname=com.microsoft.sqlserver.jdbc.SQLServerDriver
#spring.jpa.database-platform=org.hibernate.dialect.SQLServer2012Dialect
#spring.jpa.properties.hibernate.default_schema=<config_me-Schema Name>
#io.udentify.activedialect=MsSQL