Push Server Administration
PowerAuth Push Server can be administered using a RESTful API.
The RESTful API is documented in a dedicated chapter.
Administration using Insomnia
Insomnia is an easy to use RESTful API client. You can get Insomnia from https://insomnia.rest
To import the Push Server workspace into Insomnia, create a workspace using menu in the top left corner. Use the Create Workspace
option and then click Import/Export
. You can import the workspace with all requests from provided workspace export file.
All requests which are described below are already prepared in the provided Insomnia worskpace, so you can easily update the JSON requests and execute them.
Administration using cURL
Curl is a command line HTTP client. You can get cURL from https://curl.haxx.se
Retrieve Application List
curl --request GET \
--url http://localhost:8080/powerauth-push-server/admin/app/list
Retrieve Unconfigured Application List
curl --request GET \
--url http://localhost:8080/powerauth-push-server/admin/app/unconfigured/list
Create an Application
curl --request POST \
--url http://localhost:8080/powerauth-push-server/admin/app/create \
--json '{
"requestObject": {
"appId": 1
}
}'
Update the appId
value with requested PowerAuth application ID. The value appId
from response object will be used for identification of the Push Server application.
Get Application Detail
curl --request POST \
--url http://localhost:8080/powerauth-push-server/admin/app/detail \
--json '{
"requestObject": {
"appId": 1,
"includeIos": true,
"includeAndroid": true,
"includeHuawei": true
}
}'
Update the appId
value with requested Push Server application ID.
Update APNs Configuration
curl --request POST \
--url http://localhost:8080/powerauth-push-server/admin/app/ios/update \
--json '{
"requestObject": {
"appId": 1,
"bundle": "com.wultra.myApp",
"keyId": "keyId",
"teamId": "teamId",
"privateKeyBase64": "a2V5"
}
}'
Set the appId
value for Push Server application ID to want to update.
Enter the base64-encoded value of APNs private key into privateKeyBase64
.
You can encode the file using base64
command on Mac. You can also use Certutil.exe
on Windows or OpenSSL on all platforms.
base64 -i <in-file> -o <outfile>
Remove APNs Configuration
curl --request DELETE \
--url http://localhost:8080/powerauth-push-server/admin/app/ios/remove \
--json '{
"requestObject": {
"appId": 1
}
}'
Set the appId
value for the Push Server application ID you want to update.
Update FCM Configuration
curl --request POST \
--url http://localhost:8080/powerauth-push-server/admin/app/android/update \
--json '{
"requestObject": {
"appId": 1,
"projectId": "projectId",
"privateKeyBase64": "a2V5"
}
}'
Set the appId
value for Push Server application ID to want to update.
Enter the base64-encoded value of FCM private key into privateKeyBase64
.
You can encode the file using base64
command on Mac. You can also use Certutil.exe
on Windows or OpenSSL on all platforms.
base64 -i <in-file> -o <outfile>
Remove FCM Configuration
curl --request DELETE \
--url http://localhost:8080/powerauth-push-server/admin/app/android/remove \
--json '{
"requestObject": {
"appId": 1
}
}'
Set the appId
value for the Push Server application ID you want to delete.
Update Huawei Configuration
curl --request POST \
--url http://localhost:8080/powerauth-push-server/admin/app/huawei/update \
--json '{
"requestObject": {
"appId": 1,
"projectId": "projectId",
"clientId": "oAuth 2.0 client ID",
"clientSecret": "oAuth 2.0 client secret"
}
}'
Set the appId
value for Push Server application ID to want to update.
Remove Huawei Configuration
curl --request DELETE \
--url http://localhost:8080/powerauth-push-server/admin/app/huawei/remove \
--json '{
"requestObject": {
"appId": 1
}
}'
Set the appId
value for the Push Server application ID you want to delete.
Administration using SQL Database
Push server can be also administered by updating the push_app_credentials
table.
See the PowerAuth Push Server Database Structure for more details.