cert_copy

Description:

cert copy

cert_copy #
Tilko에서 제공하는 "보안 모듈 스크래핑 API 서비스"를 Flutter에서도 사용할 수 있는 Plugin

건강 관련 API사용을 위해, PC에 있는 공동인증서를 모바일로 복사해주는 기능 제공


Tilko : https://www.tilko.net/
틸코블렛은 "초기 스타트업을 위한 손쉬운 보안 모듈 스크래핑 API 서비스"를 제공하는 슬로건 아래 복잡하고 어려운 보안 모듈 웹 사이트(공인인증서, 전자인증서 및 각종 보안 프로그램 탑재)의 스크래핑 API를 제공하는 회사입니다.





APIs
Functions
내용
제공기관




인증서 등록
callCertRegister
국민건강보험공단에 인증서 등록을 할 수 있습니다. 아래의 API들을 사용하기 위해서 최초 1회 공동인증서 등록을 하여야 합니다.
건강보험공단


건강검진내역
callHealthCheckInfo
최근 10년간 건강보험공단에서 실시한 건강검진의 정보를 제공합니다.
건강보험공단


진료 및 투약 정보
callMedicalTreatment
진료 및 투약 정보를 확인할 수 있습니다.
건강보험공단




Install #
1) Dependency 추가
pubspec.yaml의 dependencies에 작성
dependencies:
tilko_plugin: ^{latest version}
copied to clipboard
dependency 추가 후, flutter pub get 실행하기
2) Dart code에 import
import 'package:tilko_plugin/tilko_plugin.dart';
copied to clipboard

Getting Start #
[Android] #
android/app/build.gradle 에서 compileSdkVersion 29, minSdkVersion 24, targetSdkVersion 29로 설정
android {
compileSdkVersion 29 //수정

sourceSets {
main.java.srcDirs += 'src/main/kotlin'
}

defaultConfig {
applicationId "com.example.plugin_example"
minSdkVersion 24 //수정
targetSdkVersion 29 //수정
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
}
copied to clipboard
[iOS] #
ios - Podfile에서 # platform :ios, '9.0'를 11 이상으로 설정
// ex)
platform :ios, '11.0'
copied to clipboard

Plugin 사용법 #
1. 공동인증서 복사 #
step 1 ) 8자리 인증키 받아오기

호출 함수

String key;
key = await TilkoPlugin.getKey();
copied to clipboard

리턴값(key) 예시 : 12345678

step 2 ) 복사되어 존재하는 공동인증서 불러오기

호출 함수

Map<String, List<String>> certMap = {};
certMap = await TilkoPlugin.getCertificate(_platformVersion)
copied to clipboard

certMap Key&Value




Key
Value




name
공동인증서 소유자 이름 리스트


valid
공동인증서 유효기간 리스트


filePath
공동인증서 파일 경로 리스트




2. API 호출 #
step 1 ) 사용할 API를 위한 Setting

발급받은 API-KEY를 위한 변수 선언


ex) apiKey = 09594kf324p04tt0nn2weg453c8j2p9l ;
apiKey는 tilko에 가입하여 발급받을 수 있습니다.

step 2 ) 사용할 API의 body list Map생성

reference: https://tilko.net/Market

step 3 ) API 호출

호출 함수


// 건강보험공단 인증서 등록 API
jsonString1 = TilkoPlugin.callCertRegister(apiKey, certMap['filePath']![index], identityNumber, certPassword);

// 건강검진내역 API
jsonString2 = TilkoPlugin.callHealthCheckInfo(apiKey, certMap['filePath']![index], certPassword);

// 진료 및 투약 정보 API
jsonString3 = TilkoPlugin.callMedicalTreatment(apiKey, certMap['filePath']![index], certPassword);
copied to clipboard

API 호출 시 파라미터 설명




변수
설명




apiKey
tilko에서 발급한 개인 APIKEY


certMap['filePath']![index]
사용할 공동인증서의 파일 경로


identityNumber
공동인증서 소유자의 주민등록번호


certPassword
공동인증서 비밀번호