ServicePermission (Java Platform SE 8 )

java.lang.Object
- java.security.Permission
- - javax.security.auth.kerberos.ServicePermission

All Implemented Interfaces:

Serializable ， Guard
```
public final class ServicePermission
extends Permission
implements Serializable
```
此类用于保护Kerberos服务和访问这些服务所必需的凭据。服务主体和访问服务所必需的凭据有一对一的映射。因此，授予对服务主体的访问权隐含地授予对与服务主体建立安全上下文所必需的凭证的访问。无论凭据是在缓存中还是通过与KDC的交换获取，这都适用。凭证可以是从钥匙表中获得票证，服务票或秘密密钥。
ServicePermission包含一个服务主体名称和一个操作列表，该列表指定凭证可以在其中使用的上下文。

服务主体名是的规范名称KereberosPrincipal供应服务，即KerberosPrincipal表示Kerberos服务主体。该名称以区分大小写的方式处理。本身可能出现星号，表示任何服务主体。

授予此权限意味着呼叫者可以在动作指定的上下文中使用缓存凭据（TGT，服务票或秘密密钥）。在TGT的情况下，授予该权限也意味着可以通过认证服务交换获得TGT。

可能的行动是：
```
  initiate -              allow the caller to use the credential to
                            initiate a security context with a service
                            principal.

    accept -                allow the caller to use the credential to
                            accept security context as a particular
                            principal. 
```
例如，要指定访问TGT以启动安全上下文的权限，则权限的构建如下：
```
  ServicePermission("krbtgt/EXAMPLE.COM@EXAMPLE.COM", "initiate"); 
```
要获得使用“主机”服务启动上下文的服务票据，该权限的构造如下：
```
  ServicePermission("host/foo.example.com@EXAMPLE.COM", "initiate"); 
```
对于Kerberized服务器，该操作是“accept”。例如，访问和使用Kerberized“主机”服务（telnet等）的密钥所需的权限将被构建如下：
```
  ServicePermission("host/foo.example.com@EXAMPLE.COM", "accept"); 
```
从以下版本开始：

1.4

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`ServicePermission(String servicePrincipal, String action)` 创建一个新的 `ServicePermission`与指定的 `servicePrincipal`和 `action` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` 检查两个ServicePermission对象是否相等。
`String`	`getActions()` 返回动作的规范字符串表示形式。
`int`	`hashCode()` 返回此对象的哈希码值。
`boolean`	`implies(Permission p)` 检查此Kerberos服务权限对象是否“暗示”指定的权限。
`PermissionCollection`	`newPermissionCollection()` 返回一个用于存储ServicePermission对象的PermissionCollection对象。

Methods inherited from class java.security.Permission
checkGuard, getName, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - ServicePermission
```
public ServicePermission(String servicePrincipal,
                         String action)
```
    创建一个新的 ServicePermission与指定的 servicePrincipal和 action 。
    
    参数
    
    servicePrincipal - 服务主体的名称。本身可能出现星号，表示任何服务主体。
    
    action - 动作字符串
- 方法详细信息
  - implies
```
public boolean implies(Permission p)
```
    检查此Kerberos服务权限对象是否“暗示”指定的权限。
    如果上述都没有， implies返回false。
    
    Specified by:
    
    implies在类别 Permission
    
    参数
    
    p - 允许检查。
    
    结果
    
    如果此对象隐含指定的权限，则为true，否则为false。
  - equals
```
public boolean equals(Object obj)
```
    检查两个ServicePermission对象是否相等。
    
    Specified by:
    
    equals在类别 Permission
    
    参数
    
    obj - 要测试与此对象相等的对象。
    
    结果
    
    如果 obj是ServicePermission，并且具有相同的服务主体，以及作为ServicePermission对象的操作，则为true。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    返回此对象的哈希码值。
    
    Specified by:
    
    hashCode在类别 Permission
    
    结果
    
    该对象的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - getActions
```
public String getActions()
```
    返回动作的规范字符串表示形式。始终以以下顺序返回当前操作：启动，接受。
    
    Specified by:
    
    getActions在类别 Permission
    
    结果
    
    这个权限的动作。
  - newPermissionCollection
```
public PermissionCollection newPermissionCollection()
```
    返回一个用于存储ServicePermission对象的PermissionCollection对象。
    必须以允许以任何顺序将它们插入到集合中的方式来存储ServicePermission对象，但这也允许以有效（一致的）方式实现PermissionCollection implicit方法。
    
    重写：
    
    newPermissionCollection在类别 Permission
    
    结果
    
    适用于存储ServicePermissions的新PermissionCollection对象。

Class ServicePermission

构造方法摘要

方法摘要

Methods inherited from class java.security.Permission

Methods inherited from class java.lang.Object

构造方法详细信息

ServicePermission

方法详细信息

implies

equals

hashCode

getActions

newPermissionCollection