WebLogic Server 12c中的Restful管理服务

Posted on 2012年02月28日 by 牛秀元

环境：WebLogic Server 12.1.1（下载）

测试工具：REST Console （下载）

基础知识

支持资源类型：JSON、XML、HTML

单资源展示格式（以JSON举例）

{
  "body": {
    "item": {
      // attributes for the item, e.g.
      // "name": "adminserver"
      // "state": "RUNNING",
      // …
    }
  },
  "messages": [
    // an array of messages
  ]
}

集合资源展标格式

{
 "body": {
  "items": [
    {
      // attributes for item 1
      // "name": "adminserver"
      // "state": "RUNNING",
      // …
     },
    {
      // attributes for item 2
     },
     …
    {
      // attributes for item n
     }
    ],
   "messages": [
    ]
}

REST资源列表

监控所有服务器

http(s)://host:port/management/tenant-monitoring/servers

监控指定服务器

http(s)://host:port/management/tenant-monitoring/servers/{servername}

监控服务器所有集群

http(s)://host:port/management/tenant-monitoring/clusters

监控指定集群

http(s)://host:port/management/tenant-monitoring/clusters/{clustername}

监控所有应用

http(s)://host:port/management/tenant-monitoring/applications

监控指定应用

http(s)://host:port/management/tenant-monitoring/applications/{applicationname}

监控所有数据源

http(s)://host:port/management/tenant-monitoring/datasources

监控指定数据源

http(s)://host:port/management/tenant-monitoring/datasources/{datasourcename}

配置过程

1. 激活RESTful服务

进入控制台->[Your Domain]->Configuration->Advanced->Enable RESTful Management Services

2. 使用REST Console进行测试

Request URI: http://localhost:7001/management/tenant-monitoring/servers
Content-Type:application/json

参考资料

Overview OTN: http://www.oracle.com/technetwork/middleware/weblogic/documentation/index.html

WLS 12c Data sheet: http://www.oracle.com/us/products/middleware/application-server/oracle-weblogic-server-ds-1391360.pdf

WLS 12c online Documentation Library: http://docs.oracle.com/cd/E24329_01/index.htm

Usind RESTful Services With WLS 12c: http://docs.oracle.com/cd/E24329_01/web.1211/e26722/toc.htm

userconfig与userkey理解与应用

Posted on 2011年03月26日 by 牛秀元

为什么需要userconfig与userkey？

举例来说：如果我们想让某人去执行编写一些WLST管理脚本，但又不想告诉对方管理员与用户名密码，如何实现呢？再比如，我们想写一些自动执行的WLST脚本，不想在执行过程中弹出题示框让用户输入用户名与密码，同时又不想把用户名与密码写死在脚本中，又如何实现？所有这些就需要用到userconfig与userkey，简单来说userconfig文件就代表用户名，而userkey文件则代表密码，当需要用户认证时，只要出示这两个文件即可。

如何生成userconfig与userkey？

1. 进入目录WL_HOME/common/bin

2. 执行wlst.cmd/sh

3. 连接到Admin Server

connect( username, password, url )

4. 执行命令生成userconfig与userkey文件

storeUserConfig(‘<userConfigFile>’, <userKeyFile>’)

例如：

storeUserConfig(‘C:/myFiles/myuserconfigfile.secure’, ‘C:/myFiles/myuserkeyfile.secure’)

这样，我们就得到了userconfig与userkey文件

如何使用userconfig与userkey？

userconfig与userkey一般是用在WLS脚本中，例如：

connect(userConfigFile=’C:/bea922/user_projects/domains/config-file’,userKeyFile=’C:/bea922/user_projects/domains/keyfile’,url=’t3://10.10.71.79:7001′)

或

nmConnect(userConfigFile=’C:/bea922/user_projects/domains/config-file’,userKeyFile=’C:/bea922/user_projects/domains/keyfile’, host=’10.10.71.79′, port=’5556′, domainName=’SAML_SOURCE’, domainDir=’C:/bea922/user_projects/domains/SAML_SOURCE’, nmType=’plain’)

如何通过userconfig与userkey文件反解析出用户名与密码？

样例Java代码：

import weblogic.security.UserConfigFileManager;
import weblogic.security.UsernameAndPassword;
public class SecureReader {
	public static void main( String[] args ) {
		UsernameAndPassword usernameAndPassword = UserConfigFileManager.getUsernameAndPassword( "d:/myuserconfigfile.secure", "d:/myuserkeyfile.secure", "weblogic.management" );
		String username = new String( usernameAndPassword.getUsername() );
		String password = new String( usernameAndPassword.getPassword() );
		System.out.println( "Username=" + username + ", Password=" + password );
	}
}

编译执行：

D:\>javac -classpath S:\fmw\wlserver_10.3\server\lib\weblogic.jar SecureReader.java
D:\>java -classpath S:\fmw\wlserver_10.3\server\lib\weblogic.jar;. SecureReader
Username=weblogic, Password=welcome1

（完）

WebLogic YouTube在线视频

Posted on 2011年03月25日 by 牛秀元

Oracle WebLogic产品部门在YouTube上开辟了一个Oracle WebLogic产品频道用于展示WebLogic Server的新特性以及产品演示，现在共有26个视频，包括以下主题：

Coherence Server Lifecycle Management with WebLogic Server (James Bayer)
WebLogic Server JRockit Mission Control Experimental Plugin (James Bayer)
WebLogic Server Virtual Edition Overview and Deployment Oracle Virtual Assembly Builder (Mark Prichard)
Migrating Applications from OC4J 10g to WebLogic Server with Smart Upgrade (Mark Prichard)
WebLogic Server Java EE 6 Web Profile Demo (Steve Button)
WebLogic Server with Maven and Eclipse (Steve Button)
Advanced JMS Features: Store and Forward, Unit of Order and Unit of Work (Jeff West)
WebLogic Scripting Tool (WLST) Recording, editing and Playback (Jeff West)

视频地址：http://www.youtube.com/OracleWeblogic

如果你不幸是中国的网民，那么你不得不翻墙才能看到这些视频。在此，我又忍不住用“草泥马”来问候GFW以及所有与其相关的部门与个人。

（完）

WebLogic Server认证深入理解

Posted on 2011年03月19日 by 牛秀元

Principal与Subject

Principal是用户或组认证通过后赋予的标识。Principal就象是信用卡，当一个用户通过了发卡机构的认证后就发给他一张卡，表明其身份。那么同一个用户可能会办多张卡，所以一个用户就可能会有多个Principal，这就需要一个容器，这就是Subject，所以Subject更象是一个装着各种卡片的钱包。如下图：

从上图我们可以看出，用户除了本身标识以外，用户还可以属于不同的用户组，也可能归属其它类型，所以用户在完成JAAS认证登录后可能会得到几个不同的Principals，然后统统将其放入Subject中。

LoginModule

LoginModule是Authentication Provider的核心组件，也就是说真正的认证动作就是由它完成。Authentication Provider与loginModule只能是一对一的关系。对于不同的认证方式（例如：用户名/密码、证书、指纹、全程认证等）需要不同的Authentication Provider，这也意味着不同的LoginModule。如果一个安全域（Security Realm）中配置了多个Authentication Provider，那么每个Authentication Provider的LoginModule认证生成的Principals会被放入同一个Subject。另外，如果一个安全域（Security Realm）中配置了多个Authentication Provider时，这些Authentication Provider也可以指定协作关系，这由Control Flag来控制。

Principal Validation Provider

Principal Validation Provider是Authenticator Provider的helper，其主要功能是防止对Principal的恶意篡改。通常来说，每种Principal对应一种Principal Validation。Principal Validation过程：

当用户完成认证过程后，将装有Principals的Subject提交给Principal Validation Provider，由其为Principals签名，然后将Subject返回给客户，当其它安全操作需要访问Subject中的Principal时，由Principal Validation Provider检查Principal是否被恶意篡改。

完整基于WebLogic安全框架的JAAS认证过程

注：这里以相对复杂的T3应用客户端为例，基于Web的认证相对简单，其原理类似。

1. T3应用向用户或系统请求认证相关信息，如：用户名、密码、URL。

2. T3应用创建CallbackHandler包含用户认证相关信息

a. T3应用通过LoginContext将CallbackHandler传递到本地UsernamePasswordLoginModule
b. UsernamePasswordLoginModule将包含认证信息的CallbackHandler传递给WebLogic Server RMI容器

3. WebLogic Server RMI容器调用WebLogic Serve安全框架。客户端传来的包含用户认证相关信息的CallbackHandler传入WebLogic Serve安全框架。

4. WebLogic Serve安全框架为每个已配置的Authentication Provider传入新创建的包含用户认证相关信息的本地CallbackHandler，注意：此CallbackHandler不同于T3应用传入的CallbackHandler。

5. WebLogic Serve安全框架调用与Authentication Provider关联的LoginModule完成用户认证

6. 如果认证通过

Principals被Principal Validation Provider签名
LoginModule将签过名的Principals放入Subject
WebLogic Serve安全框架向T3应用返回认证状态，T3应用从WebLogic Serve安全框架取回认证过的Subject。

Identity Assertion Provider与全程认证（Perimeter Authentication）

上述讲基于Authentication Provider的认证过程中是用户或系统提供认证相关信息，例如：用户名、密码等。但是在真实的安全环境中，还有一种情况就是全程认证，也就是说用户已经在别处完成认证（例如：第三方SSO认证服务器、或证书），当用户请求到达WebLogic Server时，请求头中会带有安全令牌，要实现对安全令牌的解析就需要另一种认证提供程序，即：Identity Assertion Provider。认证过程如下：

带有令牌的用户请求先被Identity Assertion Provider截获，由其解析出相应的认证信息，例如：用户名。用户名通过JAAS的CallbackHandler传递到LoginModule完成认证过程，后面就和Authentication Provider认证过程一样了，此处不复述。这里需要注意的就是与Authentication Provider一样，每个Identity Asertion Provider只与一个LoginModule配对使用。

（完）

为Maven安装WebLogic Server插件

Posted on 2011年02月25日 by 牛秀元

对Maven的支持是WebLogic Server 10.3.4的一个新特性，通过WebLogic插件，用户可以通过Maven实现对于对应用发布周期的管理。本文将介绍此插件的制作及使用的最佳实践。

1. 制作插件

进入%WL_HOME%/server/lib目录，执行如下命令

java -jar wljarbuilder.jar -profile weblogic-maven-plugin

此命令执行后将生成 weblogic-maven-plugin.jar文件，其中包括一个pom.xml描述文件指定如下信息

groupId=com.oracle.weblogic
artifactId=weblogic-maven-plugin
version=10.3.4
packaging=maven-plugin

2. 定制pom.xml配置文件

将weblogic-maven-plugin.jar中的pom.xml文件取出（可以借助winrar或7-zip等工具)，放在%WL_HOME%/server/lib中。

如果安装插件成功后，执行命令需要输入很长的命令，例如：

shell>mvn com.oracle.com:weblogic-maven-plugin:deploy

为了避免此情况，需要做如下修改：

a. 修改%USER_HOME%/.m2/settings.xml（例如：在我的Win7上是c:/Users/gniu/.m2/settings.xml ），加入如下代码：

<pluginGroups>
	<pluginGroup>com.oracle.weblogic</pluginGroup>
</pluginGroups>

b. 修改%WL_HOME%/server/lib目录下的pom.xml文件，加入如下代码：

<plugin>
    <artifactid>maven-plugin-plugin</artifactid>
    <version>2.3</version>
    <configuration>
        <goalprefix>weblogic</goalprefix>
    </configuration>
</plugin>

c. 测试

shell>mvn weblogic:help

3. 安装插件

在%WL_HOME%/server/lib目录下执行如下命令：

shell>mvn install
shell>mvn install:install-file -Dfile=weblogic-maven-plugin.jar -DpomFile=pom.xml

4. 测试插件

创建mvn项目，此过程略，pom.xml文件如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.oraclefmw</groupId>
	<artifactId>sample-web</artifactId>
	<version>1.0-SNAPSHOT</version>
	<packaging>war</packaging>
	<name>sample-web</name>
	<url>http://www.oraclefmw.com</url>
	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>
	<dependencies />
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-war-plugin</artifactId>
				<version>2.1</version>
				<configuration>
					<failOnMissingWebXml>false</failOnMissingWebXml>
				</configuration>
			</plugin>
			<plugin>
				<groupId>com.oracle.weblogic</groupId>
				<artifactId>weblogic-maven-plugin</artifactId>
				<version>10.3.4</version>
				<configuration>
					<adminurl>t3://localhost:7001</adminurl>
					<name>sample-web</name>
					<user>weblogic</user>
					<remote>true</remote>
					<upload>true</upload>
					<password>welcome1</password>
					<source>target/sample-web.war</source>
				</configuration>
			</plugin>
		</plugins>
		<finalName>sample-web</finalName>
	</build>
</project>

部署应用测试

shell>mvn weblogic:deploy

5. 注意事项

看到Mark Nelson的博客有如下代码：

<pre class="xml" name="code"> <executions>
<execution>
    <id>deploy</id>
    <phase>pre-integration-test</phase>
    <goals>
        <goal>deploy</goal>
    </goals>
    <configuration>
        <source>target/wldemo.war</source>
    </configuration>
</execution>
</pre>

我也尝试为每个goal指定不同的configurations，但是未试成功，未找到解决方案，不知道他是怎么成功的。

参考资料

（完）

Oracle融合中间件研究

专注于Oracle融合中间件产品及方案

Category Archives: WebLogic Server

WebLogic Server 12c中的Restful管理服务

基础知识

REST资源列表

配置过程

参考资料

userconfig与userkey理解与应用

为什么需要userconfig与userkey？

如何生成userconfig与userkey？

如何使用userconfig与userkey？

如何通过userconfig与userkey文件反解析出用户名与密码？

WebLogic YouTube在线视频

为Maven安装WebLogic Server插件

1. 制作插件

2. 定制pom.xml配置文件

3. 安装插件

4. 测试插件

5. 注意事项

参考资料