PASS 인증서

내 휴대폰번호로 서울시 생활복지 서비스를 이용합니다.

개인정보 제3자 제공동의

서울시 생활 복지는 PASS 인증서의 원활한 진행을 위해 다음과 같은 정보를 주식회사 아톤, SK텔레콤 주식회사, 주식회사 케이티, 주식회사 LG유플러스에 제공합니다. 취득한 개인정보는 “통신비밀보호법”, “전자통신사업법”, 전자서명법 및 “정보통신망 이용촉진 및 정보보호 등에 관한 법률” 등 정보통신서비스 제공자가 준수하여야 할 관련 법령 상의 개인정보 보호 규정을 준수합니다.

- 제공받는자 : (주)아톤, SK텔레콤(주), (주)KT, (주)LG유플러스

- 제공 목적 : 본인 확인을 통한 부정이용 방지(인증서 발급/재발급/삭제, 서비스 제공)

- 제공하는 개인정보 : 전화번호, 이름, 생년월일, 통신사

- 보유기간 : 본 서비스 해지 시 까지 또는 관계 법령에 따른 보관의무 기간 동안 보관

“서비스” 제공을 위해 필요한 최소한의 개인정보이므로 동의를 해주셔야 “서비스” 이용이 가능합니다.

PASS 인증서

휴대폰 PASS앱에서 인증을 완료해주세요.

  1. STEP1.내 휴대폰번호로 발송된 PUSH 선택
  2. STEP2.PASS에 등록한 PIN또는 생체인증
  3. STEP3.인증 완료 후, 아래 로그인버튼 클릭

PUSH가 오지 않은 경우,
스마트폰에서 PASS를 실행해주세요.

테스트 페이지

신 서버 (t-4user.yeskey.or.kr)

'https://t-certcld.yeskey.or.kr'에 접속 불가하신 기관은 테스트가 불가능합니다.
(포트 : 443)
  * 내부망에서 테스트하시는 경우는 host 파일에
   t-certcld.yeskey.or.kr 203.175.190.168를 추가하셔야 합니다.

확인 방법 :
IE를 제외한 크롬, 파이어폭스 등 브라우저 주소창에 https://t-certcld.yeskey.or.kr를 입력한 후
{"resp_code": "O0301", "rsp_message": "API 요청 처리불가 (존재하지 않는 API, 지원하지 않는 Method 등)}"
이 표시되는지 확인}

추가적으로 인증서 발급 기능을 테스트 하실 분들은
'https://t-certapi.yeskey.or.kr'에 접속 불가하신 기관은 테스트가 불가능합니다.
(포트 : 443)
  * 내부망에서 테스트하시는 경우는 host 파일에
   t-certapi.yeskey.or.kr 203.175.190.167를 추가하셔야 합니다.

* 파라미터를 모두 비울 시에 parameter에 JSON 객체가 넘어가지 않게도 셋팅 가능합니다.
(파라미터 체크 테스트용)

init()


이용기관 코드 :
이용기관 API KEY :
(참고 - 결제원 앱용 : f94451eb-d86e-4508-bc9b-da125197d1eb)
앱 고유 정보 (App Only) :
사용자 연결기기 프로그램에서만 유도할 수 있는 고유값 (App Only) :
클라이언트 종류 (App Only) :
언어 :
CSS 경로 :


saveInLocalStroage(오) :

saveInLocalStorage(정) :

자동연결표시 여부 :

자동연결 정보를 APP 내에 저장할지 여부 :

사용자가 인증서 발급 버튼을 클릭했을 때 이벤트를 받을 콜백 함수 여부 :


disconnectCloudConn()



checkCloudConn()

거래 고유 ID :


setSubAuthData()

테스트를 해보시고 싶은 분은 이쪽으로

대체인증 (MO 생략)을 위한 '거래 고유 ID' :
대체인증 (MO 생략)을 위한 '대체인증 허가코드' :
전화번호 :
이름 :
생년월일(8자리) :



issue()

참조번호 :
인가코드 :
(RA 시스템을 이용하거나 테스트인증서 발급 사이트 에서 참조번호/인가코드를 받으시기 바랍니다.)
테스트인증서 발급 사이트를 통한 경우 '인증서 정책'에 '금융인증서 개인'이 선택되어 있는지 꼭 확인!
간편인증토큰 필요 여부
완료 페이지 표시 여부

sign() / signWithoutUI() / signEnvelop()

  1. 전자서명 원문 관련 정보 (content)
    1. 평문 형식의 전자서명 원문 관련 정보 설정 (CMS 포맷 허용)
      1. 전자서명 원문 (content.plainText.plainTexts)
      2. 전자서명 인코딩 (content.plainText.encoding)
    2. 바이너리 형식의 전자서명 원문 관련 정보 설정 (CMS / PKCS1 포맷 허용)
    3. 해시 형식의 전자서명 원문 관련 정보 설정 (CMS 포맷 허용)
      1. 전자서명 원문 (content.hash.hashes)
      2. 해시에 사용한 알고리즘 (content.hash.hashAlgorithm)
    4. UCPID 본인확인용 전자서명 원문 관련 정보 설정 (CMS 포맷 허용)
      1. 원문에 사용할 이용약관 정보 문자열 (userAgreement)
      2. 요청할 이용자 정보 항목
        1. 이용자 실명 (realName)
        2. 이용자 성별 (gender)
        3. 이용자 국적 (nationalInfo)
        4. 이용자 생년월일 (birthDate)
        5. 이용자 CI (ci)
      3. 현재 이용기관의 도메인 정보 (ispUrlInfo)
      4. 검증 서버와 교환한 Nonce를 hexa 인코딩한 값 (ucpidNonce)
      5. Open UCPID 서버로 전송 여부
    5. 다자서명용 원문 정보 설정 (CMS 포맷 허용)
  2. 전자서명 데이터 포맷 관련 정보 (signFormat)
    1. 서명 데이터 포맷 (signFormat.type) :
    2. CMS 추가 정보 (signFormat.CMSInfo)
      1. 주민(사업자)등록번호 (signFormat.CMSInfo.ssn) :
      2. 서명 시각 (signFormat.CMSInfo.time) :
      3. 서명 contents 미포함 여부 (signFormat.CMSInfo.withoutContent) :
      4. ContentInfo 형식의 CMS Signed Data 생성 여부 (signFormat.CMSInfo.generalSyntax) :
      5. VID 검증을 위한 R값을 전자서명 결과에 포함할지 여부 (signFormat.CMSInfo.includeR) :
    3. PKCS1 추가 정보 (signFormat.PKCS1Info)
      1. VID 검증을 위한 R값을 전자서명 결과에 포함할지 여부 (signFormat.PKCS1.includeR) :
  3. 서명 알고리즘 (algorithms) :
  4. 전자서명 표시 관련 옵션 (view)
    1. 마지막에 사용한 인증서만 표시 여부 (view.lastAccessCert) :
    2. 인증서 선택창 표시 OID (view.oid) : {
      '1.2.410.200005.1.1.1.10' :
      }
    3. 서명 내용 표시 여부 (view.enableTextView) :
    4. 서명 내용 표시 여부 관련 추가 정보 필드 (view.enableTextViewAddInfo)
      1. 쿼리 스트링 형식의 전자서명 원문인 경우
        name과 value를 구분하기 위한 separator
        (view.enableTextViewAddInfo.nameValueSeparator) :
      2. 쿼리 스트링 형식의 전자서명 원문인 경우
        name과 value의 쌍들 사이를 구분하기 위한 separator
        (view.enableTextViewAddInfo.pairSeparator) :
      3. 해당 항목을 표시하지 않는 regular expression
        (view.enableTextViewAddInfo.nameExclusionRegExp) :
    5. 자동 선택할 인증서의 일련번호 (view.certSeqNum) :
  5. 전자서명 관련 부가정보 (info)
    1. 사용자 전자서명 거래 종류 (info.signType) :
    2. 간편인증 등록을 위한 간편인증토큰 필요 여부 (Only in UI : info.simpleKeyReq)
  6. 전자서명 수행할 인증서의 일련번호 (certSeqNum) :
  7. 간편인증토큰 (simpleKeyToken) :
  8. 간편인증 종류 (simpleKeyType) :
  9. (signEnvelop) 서버 인증서 :
  10. signParam 개수 :



myDataSign()

orgCode (정보제공자 기관코드) :
ucpidRequestInfo : {
userAgreement (인증 약관 문자열) :
userAgreeInfo : {
realName (실명) :
gender (성별) :
nationalInfo (국적) :
birthDate (생년월일) :
ci (CI 정보) :
}
ispUrlInfo (마이데이터 서비스 도메인 정보) :
ucpidNonce (마이데이터 서버가 생성한 Nonce) :
}
consentInfo : {
consent (전송요구내역) : {
snd_org_code (정보제공자 기관코드) :
rcv_org_code (마이데이터사업자(정보수신자) 기관코드) :
is_scheduled (정기적 전송 여부) :
fnd_cycle (기본 정보의 정기적 전송 주기 단위) :
add_cycle (추가 정보의 정기적 전송 주기 단위) :
end_date (전송요구의 종료시점, YYYYMMDD) :
purpose (전송을 요구하는 목적) :
holding_period (전송을 요구하는 개인신용정보의 보유기간, YYYYMMDD) :
target_info : [
{
  
scope (전송요구 정보에 해당하는 Scope) :
asset_list (전송요구 대상 계좌(상품) 식별자 목록) : [
{
  
asset:
seqno:
},
{
  
asset:
seqno:
},
]
}
]
is_consent_trans_memo (적요 또는 거래메모 전송요구 여부) :
is_consent_merchant_name (가맹점명 전송요구 여부) :
is_consent_trans_category (상품(구매)분류 전송요구 여부) :
}
consentNonce (마이데이터 서버가 생성한 Nonce) :
}

전자서명 수행할 인증서의 일련번호 (certSeqNum) :
(myDataSignWithoutUI 만) 간편인증토큰 (simpleKeyToken) :
간편인증 종류 (simpleKeyType) :



manage()



getCertInfoList()

간편인증 등록을 위한 간편인증토큰 필요 여부


getUserInfo()



regSimpleKeyToken()

간편인증 수단을 등록할 금융인증서 일련번호
간편인증 정보를 등록하기 위한 Token
간편인증 등록을 위한 간편인증 종류


setAuthData()

생년월일
이름
전화번호
UI에서 수정 불가 여부


getCertInfo()

인증서 정보



getSignerCertFromSignedVal()

CMS 포맷의 전자서명 값



isOverseasIp()



getAvailableAuthMethod()


registerDevice()

생년월일
이름
전화번호
고객 해외 체류 여부
기기 등록 유형
인증 유형

MO 인증코드 :
MO 인증 회신번호 :

cancelDeviceRegister()

기기 등록 유형
인증 유형


getRegisterDeviceStatus()

기기 등록 유형
인증 유형


convertBase64UrlToBase64()

Base64Url 포맷의 문자열



convertBase64ToBase64Url()

Base64Url 포맷의 문자열



makeAutoConnInfo()



setAutoConnInfo()

자동연결정보


needAutoConnInfo :
isConnected :
apiTranId :

TEST FOR REG SIMPLE KEY TOKEN

조회된 첫번째 인증서에 인증서의 간편인증 토큰을 셋팅합니다.
* 조건 : 자동연결이 되어 있어야 함. 인증서가 1개 이상 있어야 함.
해당 버튼 누르고 아래의 버튼 누르기 전에 꼭 새로고침 한 후에
아래의 버튼을 눌러서 동일한 상황을 만들어주세요

TEST FOR SIGN WITH SIMPLE KEY TOKEN

조회된 첫번째 인증서에
인증서의 간편인증 토큰을 통해 전자서명을 수행합니다.
* 조건 : 자동 연결이 되어 있어야 하고
위 과정을 통해 등록이 되어 있어야 함
(네트워크 6 transaction)

bluebird.min.js 가져오기

webcrypto-shim.min.js 가져오기

자동연결정보 추출하기 (Only in IOS, Mac-Safari)



결과 :

자동연결정보 주입하기 (Only in IOS, Mac-Safari)

connInfo :

uniqValue 생성해서 확인해보기

생성 횟수 :


hex, base64, base64Url을 binary 파일로 받기


데이터 :








- 서명원문
- 전자서명 메시지