Developer Portal

API 는 네트웍 보안을 위해 TLS1.2 을 기반으로 하는 상호 인증을 거칩니다.
수신된 API 는 제휴기관의 정보등을 확인 하여 인증 처리를 거쳐 인증된 Token 값으로 요청된 전문에 대해 업무를 처리 하게 됩니다.
API 송수신은 모두 동기 방식으로 진행 되며, 응답 대기시간은 최대 60초 입니다. 응답 결과에 따라 전문 재 요청 등의 추가적인 Process를 진행합니다.

JSON (JavaScript Object Notation)
경량의 Data-교환 형식으로, 데이터를 속성-값 형식으로 표현하는 개방형 표준 Data 형태입니다.
UTF-8
유니코드를 위한 가변 길이 문자 인코딩 방식 중 하나로, 전 세계 모든 문자코드를 표현할 수 있습니다.
인증방식
OAuth2.0의 Client Credentials Grant 방식을 준용합니다. Token의 유효 시간은 86400초(24시간)이며, 유효시간이 경과하면 token을 재발급 하여야 합니다.
Token
케이뱅크에서는 Token으로 JWS(JSON Web Signature)를 사용합니다. 케이뱅크에서는 Header 및 Payload 정보를 BASE64를 Encoding 하여 token을 생성하고 이를 전달 합니다.
암복호화
제휴 기관이 케이뱅크 펌뱅킹 API 이용 승인이 되면 제공되는 ID와 Secret 외에 KEY 값을 받게 됩니다. 해당 KEY 를 이용하여 암호화된 컬럼을 복호화하여 이용할 수 있습니다. 암호화 대상컬럼에 명시된 컬럼 size는 암호화 전 기준의 size입니다. (암호화 시 부족한 컬럼 사이즈는 스페이스 처리하며 암호화 후 컬럼 사이즈는 가상계좌번호, 출금계좌번호 16byte 실명번호 24byte)
방화벽 정책
제휴기관의 도메인에 매핑된 모든 IP가 케이뱅크측 화이트리스트에 등록되어야 하므로 사전에 접속하고자하는 서버의 공인IP정보가 제공되어야 합니다.

②: ATA 속성이 “SN”인 FIELD는 그 값이 “-”인 경우는 첫 자리에 “-”를 표시하고, “0” 또는 “+”인 경우에는 해당 값을 RIGHT-JUSTIFIED하여 SET한다.

③: DATA 속성이 “A”, “AN”, “AH”, “ANS”, “AHNS”인 FIELD는 LEFT-JUSTIFIED하고, 남는 부분은 BLANK로 SET한다.

AES256 암/복호화 소스

public static String encryptAES(String key, String text) { return encrypt(key, text, "AES"); } public static String decryptAES(String key, String text) { return decrypt(key, text, "AES"); } public static String encrypt(String key, String text, String algorithm) throws IllegalArgumentException { SecretKeySpec securekey = new SecretKeySpec(key.getBytes(), algorithm); try { Cipher cipher = Cipher.getInstance(algorithm); cipher.init(Cipher.ENCRYPT_MODE, securekey); byte[] encryptedData = cipher.doFinal(text.getBytes()); char[] temp = Base64.encode(encryptedData); return new String(temp); } catch (Exception var7) { throw new IllegalArgumentException(var7.toString()); } } public static String decrypt(String key, String text, String algorithm) { Key secureKey = new SecretKeySpec(key.getBytes(), algorithm); byte[] encryptedData = Base64.decode(text.toCharArray()); try { Cipher cipher = Cipher.getInstance(algorithm); cipher.init(Cipher.DECRYPT_MODE, secureKey); byte[] plainText = cipher.doFinal(encryptedData); return new String(plainText); } catch (Exception var7) { throw new IllegalArgumentException(var7.toString()); } }

kbank