北京信城通数码科技有限公司
密级：普通秘密机密绝密 CAS6.0认证服务器接口使用手册
（C）2006-2007北京信城通数码科技有限公司版权所有
北京信城通：北京市南四环西路188号总部基地七区15号楼 邮编100070 电话 010-63702288 传真 010-63702800 上海信城通：上海市福州路666号金陵海欣大厦7楼d座 邮编200001 电话 021-63917337 传真 021-63917159 广州信城通：广州市天河北路586号帝景商业中心601室 邮编510630 电话 020-38497007 传真 020-38497001 深圳信城通：深圳市福田区天安数码时代大厦主楼1210室 邮编518048 电话 0755-33360518 传真 0755-83476748
北京信城通数码科技有限公司
版本历史
版本号 V1.0 V2.0 V3.0 生效日期 2007-5-17 2007-5-30 2007-9-23 建立 修改 修改整合 版本说明/变更理由/变更内容 作者 霍云 霍云 霍云 备注 变更说明：C：Create，初始创建；A：Add，增加内容；M：Mod，修改；D：Del，删除 北京信城通：北京市南四环西路188号总部基地七区15号楼 邮编100070 电话 010-63702288 传真 010-63702800 上海信城通：上海市福州路666号金陵海欣大厦7楼d座 邮编200001 电话 021-63917337 传真 021-63917159 广州信城通：广州市天河北路586号帝景商业中心601室 邮编510630 电话 020-38497007 传真 020-38497001 深圳信城通：深圳市福田区天安数码时代大厦主楼1210室 邮编518048 电话 0755-33360518 传真 0755-83476748
北京信城通数码科技有限公司
目录
1 前言 ................................................................................................................................................. 5 1.1 公司简介 ..................................................................................................................................................... 5 2 J2EE接口 ....................................................................................................................................... 5 2.1 接口介绍 ..................................................................................................................................................... 5 2.2 接口安装 ..................................................................................................................................................... 6 2.2.1 Casproxy.jar ........................................................................................................................................... 6 2.2.2 加载服务器组件到应用系统中 ............................................................................................................. 6 2.2.2.1 Web.xml ................................................................................................................................. 6 2.2.2.2 拷贝配置文件 .......................................................................................................................... 7 2.2.2.3 拷贝运行文件 .......................................................................................................................... 8 2.2.2.4 cas.properties ....................................................................................................................... 8 2.2.2.5 caslog.xml ............................................................................................................................. 9 2.3 接口说明 ................................................................................................................................................... 11 2.3.1 函数说明 ............................................................................................................................................... 11 2.3.1.1 类 AuthBroker .................................................................................................................... 11 2.3.1.2 接口 AuthBrokerIF ............................................................................................................. 12 2.3.2 使用示例 ............................................................................................................................................... 15 3 C接口 ............................................................................................................................................ 19 3.1 接口介绍 ................................................................................................................................................... 19 3.2 安装说明 ................................................................................................................................................... 19 3.2.1 解压缩 ................................................................................................................................................... 19 3.2.2 config说明 ............................................................................................................................................ 21 3.2.2.1 casserver.config ................................................................................................................. 21 3.2.2.2 casclient.config .................................................................................................................. 22 3.2.3 配置环境 ............................................................................................................................................... 22 3.3 C接口说明 ............................................................................................................................................... 23 3.3.1 创建代理 ............................................................................................................................................... 23 3.3.2 注销代理 ............................................................................................................................................... 23 3.3.3 证书用户登录 ....................................................................................................................................... 23 3.3.4 证书用户登出 ....................................................................................................................................... 24 3.3.5 口令用户登录 ....................................................................................................................................... 24 3.3.6 口令用户登出 ....................................................................................................................................... 24 3.3.7 用户令牌校验 ....................................................................................................................................... 24 3.3.8 用户令牌校验并取用户属性（接口1） ............................................................................................ 25 3.3.9 用户令牌校验并取用户属性（接口2） ............................................................................................ 25 3.3.10 用户令牌比较 ....................................................................................................................................... 26 3.4 调用说明 ................................................................................................................................................... 26 3.5 返回值代码 ............................................................................................................................................... 27 4 CAS for CIQ接口（C接口和PowerBuilder接口） ................................................................... 27 4.1 接口介绍 ................................................................................................................................................... 27 4.2 接口安装 ................................................................................................................................................... 27 4.2.1 解压缩 ................................................................................................................................................... 27 4.2.2 config说明 ............................................................................................................................................ 28 4.2.3 配置环境 ............................................................................................................................................... 30 4.2.4 安装成功测试 ....................................................................................................................................... 30 4.3 接口说明 ................................................................................................................................................... 33 4.3.1 函数说明 ............................................................................................................................................... 33 4.3.1.1 C接口说明 ........................................................................................................................... 33 4.3.1.2 PowerBuilder调用说明 ....................................................................................................... 33 4.3.2 返回码定义 ........................................................................................................................................... 34
CAS6.0认证服务器-接口使用手册-V2.0 第 3 页 共 35 页
北京信城通数码科技有限公司
5 技术支持及售后服务...................................................................................................................... 35
CAS6.0认证服务器-接口使用手册-V2.0 第 4 页 共 35 页
北京信城通数码科技有限公司
1 前言
1.1 公司简介
北京信城通数码科技有限公司（以下简称信城通）是2001年8月在北京中关村科技园区丰台园注册成立的高新技术企业，是经信息产业部批准的跨地区增值电信业务服务商。
信城通的业务主要涉及电子数据交换服务、在线数据处理服务、在线交易处理服务、网络信息技术服务、信息安全服务、产品及应用软件研发等领域。公司80％以上的员工拥有本科及以上学历，同时拥有多位业内顶级技术专家与资深业务骨干。凭借良好的人才优势、强大的技术实力与专业的服务队伍，为各级检验检疫机构及广大进出口企业用户提供优质的产品和服务，并成为联接二者的优秀桥梁。
经信息产业部电信管理部门审核批准，公司获得了《中华人民共和国电信与信息服务经营许可证》（京ICP 证010524）。2001年9月20日取得《中关村科技园丰台园高新技术企业证书》（证书号：0121618F）。2005年8月18日，信城通通过ISO9001：2000标准质量管理体系认证，并已经正式启动CMMI的认证进程。
北京信城通数码科技现有员工150多人，全部为大专以上学历，其中硕士占7%，本科占70%，大专占23%。高级管理人员14%，技术人员62%，一般管理人员24%。
2005年11月28日，信城通正式入住位于中关村科技园区丰台园总部基地的新办公楼，它是信城通自成立以来快速发展的标志，也是信城通今后长期稳定发展的坚实基础。 信城通将始终秉承以用户为中心、以市场为导向、以服务为基础、以技术为后盾、以创新求发展、以诚信立长久的企业宗旨，脚踏实地，开拓进取，持续不断地为广大用户提供优质的产品和服务。
2 J2EE接口
2.1 接口介绍
本手册介绍了CAS6.0认证服务器的门户接口函数。这部分接口函数实现了两类功能：用户的标识校验和取证书的相关信息。本接口主要用于应用程序和CAS的整合，通过调用本接口，应用程序使用CAS提供的认证服务。本接口适用于Java形式的应用程序。
CAS6.0认证服务器-接口使用手册-V2.0 第 5 页 共 35 页