程序文档之Passport

 程序文档  程序文档  Passport   2019-05-08 16:15 

Passport

请注意:此程序已经过重构,依赖此程序的其他程序若出现认证异常,烦请联系我修改,邮箱staugur@saintic.com。

程序描述:Unified authentication and authorization management SSO system for SaintIC Web  Applications.

代码仓库:https://github.com/staugur/passport

详细文档:http://docs.saintic.com/passport/install.html

以下是简略型文档:

1. 下载安装

1.0 yum install -y gcc gcc-c++ python-devel libffi-devel openssl-devel mysql-devel
#开发版本体验
1.1 git clone https://github.com/staugur/passport &&\
    cd passport
#稳定版本体验
1.1 wget -c -O passport-1.0.3.tar.gz https://codeload.github.com/staugur/passport/tar.gz/v1.0.3 &&\
    tar zxf passport-1.0.3.tar.gz &&\
    cd passport-1.0.3/
#
1.2 pip install -r requirements.txt

如果git没有安装,那么执行yum -y install git

如果pip没有安装,那么执行yum -y install python-pip(没有python-pip,可先yum -y install epel-release)


2.程序准备

2.1 修改配置文件config.py(必要选项)

2.2 创建库,要求utf8,utf8_unicode_ci

2.3 写入数据库

使用工具或command line导入misc/passport.sql文件


3. 运行使用

3.1 sh online_gunicorn.sh start|stop|restart|status

3.2 supervisord

[program:passport]
command=gunicorn -w $cpu_count --threads 16 -b ${host}:${port} main:app -k gevent --log-file $logfile --max-requests 250 --name $procname #变量自行修改,未测试
directory=程序src目录
autostart=true
autorestart=true
startsecs=5
priority=1
stopasgroup=true
killasgroup=true

3.3 docker(参考详细文档)

3.4 开发启用

    python main.py

3.5 建立管理员账号(!!!)

    3.5.1 执行命令 python cli.py --createSuperuser 根据提示可以创建管理员用户。


4. 客户端

目前基于passport认证的项目有:EauDouceCherryWaterfall, IncetOps

上述项目中,EauDouce(本站,www.saintic.com)、IncetOps(incetops.saintic.com)为作者官方网站,可以使用https://passport.saintic.com提供的服务,其他情况需要您单独部署passport项目。

    passport代码里有一个demo目录,是一个演示用的客户端程序,关于使用方法说明如下,其他客户端程序类似:

    1. 修改配置文件config.py

        1.1 主要是SSO段的配置,它的信息来自于passport应用管理中(请参考本文1、2、3步骤部署,假设部署完成,域名是http://passport.demo.com)。

        登录passport.demo.com,管理员方能看见应用管理导航,点击进入,可以看到右侧有应用列表和新建应用两个标签页,点击新建应用,如图:

        1

        如图,新建应用所需参数解释如下:

            名称:对应了客户端程序config.py中GLOBAL段ProcessName值(此为默认),也可以自定义(需修改客户端config.py中SSO段app_name);

            描述:无实际意义,只是描述此应用作业;

            回调域名:对应了客户端程序运行的地址,需要完全合格域名,比如http://eaudouce.demo.com,也可以是IP:PORT形式的,请注意域名需要连通的(DNS有解析或hosts有绑定)!

        点击提交即可,注意上述信息都是客户端的,提交后在应用列表查看应用详情,客户端SSO配置段主要需要以下项:

            应用名:客户端程序config.py中SSO段的app_name,SSO中注册的应用名称;

            app_id:客户端程序config.py中SSO段的app_id;

            app_secret:客户端程序config.py中SSO段的app_secret;

            此外客户端config.py中SSO段中还有一个sso_server,即passport的完全合格域名,即假设的http://passport.demo.com。

        1.2 MYSQL、REDIS,看客户端程序需要

        1.3 SYSTEM段,主要是HMAC_SHA256_KEY、AES_CBC_KEY、JWT_SECRET_KEY,要求值与passport中一致。

    2. 运行测试使用

        python main.py



点赞 打赏
取消

感谢您的支持,我会继续努力的!

扫码支持
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

交流分享

QQ扫一扫或点击二维码加入,群号577543189
微信扫一扫,手滑关注它
微信扫一扫,进入小程序

推荐文章

标签云集

友情链接  交换友链

推广位