페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

Portal 2차 인증 URL호출 API 기능 추가



Start Release No : 7.0.400.20230511-11 / Update Release No :


작성자 :  이동진         / 검수자 : 정해영

기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend

기능 설명

  1. 실행 경로 : 로그인 화면
  2. 사용 방법
    1. 샘플 JSP를 참고하여 고객사에 알맞는 2차 인증 페이지를 작성하고 인증 완료/취소에 맞는 API를 호출합니다.
      아래는 JSP를 작성할때 필요한 코드들 이며 /extention/portal/twoFactorAuthSample.jsp 샘플 페이지를 참고합니다.

      Example code
      <script>
      //현재 접속 시도중인 사용자 아이디를 가져옵니다.
      var uid = decodeURI(Base64.decode("<%=uid%>"));
      
      
      //인증 완료 처리
      function submitCode(){
          var successYn = false;
      	/*
      		여기에 인증로직 추가........
      	*/
          if(successYn==true){
              if(opener){
                  opener.successTwoFactorAuthentication();
              }else if(parent){
                  parent.successTwoFactorAuthentication();
              }
      		closePopup();
          }
      }
      //인증페이지 닫기 로직
      function closePopup(){
          if(opener){
              opener.closePopupTwoFactorAuthentication();
          }else if(parent){
              parent.closePopupTwoFactorAuthentication();
          }
      }
      </script>
      
      

필수 옵션

  • 7.0.400.20230511-11 이전 설치 버전에서 검토 하려면/extention/portal/temp/twoFactorAuthSample.jsp 파일을 추가 해야 합니다.(해당 파일은 참고 용 파일이며 프로젝트에서 작성해서 사용 해야 합니다.)

  • 7.0.400.20230511-11 이전 설치 버전에서는 Repository에 아래 쿼리를 입력하여 데이터를 넣습니다. 상세 옵션은 "세부 기능 옵션" 표를 참고합니다.

    INSERT INTO mtx_portal_option (op_code, op_value, op_default_value, op_type, op_group_code, op_desc, create_code, create_date, modify_code, modify_date)
    VALUES('OP_2FACTORAUTH'
    , '[USE=true][IFRAME_POPUP=true][WIDTH=500][HEIGHT=600][URL=/extention/portal/twoFactorAuthSample.jsp][M_URL=/extention/portal/twoFactorAuthSample.jsp]'
    , '[USE=false][IFRAME_POPUP=true][WIDTH=500][HEIGHT=600][URL=/extention/portal/twoFactorAuthSample.jsp][M_URL=/extention/portal/twoFactorAuthSample.jsp]'
    , 'TEXT', 'PORTAL','2차인증 옵션', 'matrixadm', NULL, 'matrixadm', NULL);
  • 7.0.400.20230511-11 이후 버전에는

    ADMIN > 시스템운영관리 > Portal설정 > [더보기]버튼 클릭 > OP_2FACTORAUTH 값을 수정합니다. 상세 옵션은" 세부 기능 옵션" 표를 참고합니다.


세부 기능 옵션

세부 기능 명

내용
[USE=값]
  • 2차 인증 사용여부에 대한 값이며 true/false가 입력됩니다.
  • 입력 값
    1) true : 사용
    2) false : 미사용
[IFRAME_POPUP=값]


  • 실제 팝업이 아닌 IFrame팝업 사용여부에 대한 값이며 true/false가 입력됩니다.
  • 입력 값

    1) true : iFrame팝업을 사용합니다.



    2) false : iFrame팝업을 사용하지 않고 일반 팝업을 사용합니다.



[URL=값] 
  • PC로그인시 호출되는 2차 인증 팝업 URL을 정의하여 반드시 /extention/폴더 밑으로 정의해야 합니다.
[M_URL=값]
  • 모바일 로그인시 호출되는 2차 인증 팝업 URL을 정의하여 반드시 /extention/폴더 밑으로 정의해야 합니다.
[WIDTH=값]
  • PC로그인 2차인증 팝업 너비이며 숫자형 데이터가 입력됩니다.
[HEIGHT=값]
  • PC로그인 2차인증 팝업 높이이며 숫자형 데이터가 입력됩니다.


제약 사항

  • Repository에 쿼리를 이용하여 직접 입력 시에는 서버 재기동이 필요합니다.
  • 모바일 접속은 [WIDTH=값] [HEIGHT=값] 옵션이 적용되지 않습니다.
  • 2차 인증 URL [URL=값] [M_URL=값]에 해당하는 JSP페이지는 반드시 제품 내의 /extention/폴더 안에 넣어야합니다.
  • PC 2차 인증에 반드시 필요한 옵션은 [USE=값] [IFRAME_POPUP=값] [URL=값] [WIDTH=값] [HEIGHT=값] 입니다.
  • 모바일 2차 인증에 반드시 필요한 옵션은 [USE=값] [IFRAME_POPUP=값] [M_URL=값] 입니다.

샘플 정보


  파일 변경됨
파일 twoFactorAuthSample.jsp 2023-04-28 by 플랫폼팀

변경 전/후 제품 버전

변경 전(제품 버전)변경 후(제품 버전)

변경 전 : 7.0.400.20230427-11

변경 후 : 7.0.400.20230511-11

2차 인증 페이지 호출이 없습니다.

2차 인증 페이지를 호출합니다.

참고 자료

 여기를 클릭하여 펼치기...

  파일 변경됨
파일 twoFactorAuthSample.jsp 2023-04-28 by 플랫폼팀
PNG 파일 image2023-4-28_10-37-57.png 2023-04-28 by 플랫폼팀
PNG 파일 image2023-4-28_10-34-49.png 2023-04-28 by 플랫폼팀
PNG 파일 image2023-4-28_10-29-56.png 2023-04-28 by 플랫폼팀
PNG 파일 image2023-4-28_10-28-20.png 2023-04-28 by 플랫폼팀

문서 수정 이력

버전 날짜 댓글
현재 버전 (v. 4) 2024-08-09 16:10 품질기술팀:
7.0.500.20240808-12
v. 3 2023-05-14 15:32 품질기술팀
v. 2 2023-05-14 14:42 품질기술팀
v. 1 2023-04-28 10:58 플랫폼팀

BCRM 정보

(BCRM#D1394) Portal 2차 인증기능 추가



  • 레이블 없음