Skip to content

This is to provide Microsoft Power Platform with a custom connector for NHN Toast Notification Services including SMS/MMS and KakaoTalk messages

License

Notifications You must be signed in to change notification settings

devrel-kr/nhn-toast-notification-service-custom-connector

Repository files navigation

NHN Toast Notification Service Custom Connector

This is to provide Microsoft Power Platform with a custom connector for NHN Toast Notification Services including SMS/MMS and KakaoTalk messages.

High-Level Architecture

The elements in the green rectangle is the scope of this project.

high level architecture and scope of this project

Getting Started

GitHub Secrets

Following GitHub Secrets are required for CI/CD pipelines:

  • AZURE_CREDENTIALS: Credentials that Azure issues. To get the Azure Credentials, refer to this page.
  • AZURE_RESOURCE_NAME: Resource name. For example, if your Azure Resource Group is rg-nt-dev-krc, nt is the resource name.
  • AZURE_APP_SUFFIXES: Comma delimited Azure Function app suffixes. For example, if your Azure Functions apps are fncapp-nt-sms-dev-krc, sms is the suffix.
  • AZURE_LOCATION_CODE: Location code. For example, if your Azure Resource Group is rg-nt-dev-krc, krc is the location code.
  • AZURE_ENVIRONMENT_CODE: Environment code. For example, if your Azure Resource Group is rg-nt-dev-krc, dev is the environment code.

If you want to implement multi-stage environment – ie. DEV, TEST, PROD, etc – you need to create GitHub Environment and add this AZURE_ENVIRONMENT_CODE secret to each GitHut Environment.

The following GitHub Secrets will be deprecated soon.

  • TOAST_APPKEY: AppKey that NHN Toast issues.
  • TOAST_SECRETKEY: SecretKey that NHN Toast issues.
  • REQUEST_ID: Any request ID that was used to send SMS messages for testing.
  • SENDER_NO: Any registered and verified sender number for integration tests.
  • RECIPIENT_NO: Any registered and verified recipient number for integration tests.

Make sure that the RECIPIENT_NO is the mobile phone number authorised for testing purpose only and used with care. If you use unauthorised mobile phone numbers, you might be involved with legal actions.

Local Development

Prerequisites for Local Development

Make sure that you might need to find Docker Desktop alternatives, if you're concerned about Docker's licensing policy.

TBD

Initial Autopilot to Azure

Prerequisites for Azure

Serverless Autopilot

  1. Click the button below to autopilot all instances and apps on Azure. Make sure that you don't forget the app name you give.

    Deploy To Azure

  2. Visit the following URLs to check whether all the apps have been properly provisioned and deployed.

    • https://apim-<AZURE_RESOURCE_NAME>-<AZURE_ENVIRONMENT_CODE>-<AZURE_LOCATION_CODE>.azure-api.net/sms/swagger/ui
    • https://apim-<AZURE_RESOURCE_NAME>-<AZURE_ENVIRONMENT_CODE>-<AZURE_LOCATION_CODE>.azure-api.net/sms/verify/swagger/ui

AKS Autopilot

TBD

Initial Autopilot to NHN Cloud

Prerequisites for NHN Cloud

NKS Autopilot

TBD

Power Platform Integration

Prerequisites for Power Platform

TBD