001/**
002 * Licensed to the Apache Software Foundation (ASF) under one
003 * or more contributor license agreements.  See the NOTICE file
004 * distributed with this work for additional information
005 * regarding copyright ownership.  The ASF licenses this file
006 * to you under the Apache License, Version 2.0 (the
007 * "License"); you may not use this file except in compliance
008 * with the License.  You may obtain a copy of the License at
009 *
010 *     http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS,
014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 * See the License for the specific language governing permissions and
016 * limitations under the License.
017 */
018
019package org.apache.hadoop.util;
020
021import java.io.DataInput;
022import java.io.IOException;
023
024import org.apache.hadoop.ipc.RPC;
025import org.apache.hadoop.ipc.protobuf.IpcConnectionContextProtos.IpcConnectionContextProto;
026import org.apache.hadoop.ipc.protobuf.IpcConnectionContextProtos.UserInformationProto;
027import org.apache.hadoop.ipc.protobuf.RpcPayloadHeaderProtos.*;
028import org.apache.hadoop.security.SaslRpcServer.AuthMethod;
029import org.apache.hadoop.security.UserGroupInformation;
030
031public abstract class ProtoUtil {
032
033  /**
034   * Read a variable length integer in the same format that ProtoBufs encodes.
035   * @param in the input stream to read from
036   * @return the integer
037   * @throws IOException if it is malformed or EOF.
038   */
039  public static int readRawVarint32(DataInput in) throws IOException {
040    byte tmp = in.readByte();
041    if (tmp >= 0) {
042      return tmp;
043    }
044    int result = tmp & 0x7f;
045    if ((tmp = in.readByte()) >= 0) {
046      result |= tmp << 7;
047    } else {
048      result |= (tmp & 0x7f) << 7;
049      if ((tmp = in.readByte()) >= 0) {
050        result |= tmp << 14;
051      } else {
052        result |= (tmp & 0x7f) << 14;
053        if ((tmp = in.readByte()) >= 0) {
054          result |= tmp << 21;
055        } else {
056          result |= (tmp & 0x7f) << 21;
057          result |= (tmp = in.readByte()) << 28;
058          if (tmp < 0) {
059            // Discard upper 32 bits.
060            for (int i = 0; i < 5; i++) {
061              if (in.readByte() >= 0) {
062                return result;
063              }
064            }
065            throw new IOException("Malformed varint");
066          }
067        }
068      }
069    }
070    return result;
071  }
072
073  
074  /** 
075   * This method creates the connection context  using exactly the same logic
076   * as the old connection context as was done for writable where
077   * the effective and real users are set based on the auth method.
078   *
079   */
080  public static IpcConnectionContextProto makeIpcConnectionContext(
081      final String protocol,
082      final UserGroupInformation ugi, final AuthMethod authMethod) {
083    IpcConnectionContextProto.Builder result = IpcConnectionContextProto.newBuilder();
084    if (protocol != null) {
085      result.setProtocol(protocol);
086    }
087    UserInformationProto.Builder ugiProto =  UserInformationProto.newBuilder();
088    if (ugi != null) {
089      /*
090       * In the connection context we send only additional user info that
091       * is not derived from the authentication done during connection setup.
092       */
093      if (authMethod == AuthMethod.KERBEROS) {
094        // Real user was established as part of the connection.
095        // Send effective user only.
096        ugiProto.setEffectiveUser(ugi.getUserName());
097      } else if (authMethod == AuthMethod.DIGEST) {
098        // With token, the connection itself establishes 
099        // both real and effective user. Hence send none in header.
100      } else {  // Simple authentication
101        // No user info is established as part of the connection.
102        // Send both effective user and real user
103        ugiProto.setEffectiveUser(ugi.getUserName());
104        if (ugi.getRealUser() != null) {
105          ugiProto.setRealUser(ugi.getRealUser().getUserName());
106        }
107      }
108    }   
109    result.setUserInfo(ugiProto);
110    return result.build();
111  }
112  
113  public static UserGroupInformation getUgi(IpcConnectionContextProto context) {
114    if (context.hasUserInfo()) {
115      UserInformationProto userInfo = context.getUserInfo();
116        return getUgi(userInfo);
117    } else {
118      return null;
119    }
120  }
121  
122  public static UserGroupInformation getUgi(UserInformationProto userInfo) {
123    UserGroupInformation ugi = null;
124    String effectiveUser = userInfo.hasEffectiveUser() ? userInfo
125        .getEffectiveUser() : null;
126    String realUser = userInfo.hasRealUser() ? userInfo.getRealUser() : null;
127    if (effectiveUser != null) {
128      if (realUser != null) {
129        UserGroupInformation realUserUgi = UserGroupInformation
130            .createRemoteUser(realUser);
131        ugi = UserGroupInformation
132            .createProxyUser(effectiveUser, realUserUgi);
133      } else {
134        ugi = org.apache.hadoop.security.UserGroupInformation
135            .createRemoteUser(effectiveUser);
136      }
137    }
138    return ugi;
139  }
140  
141  static RpcKindProto convert(RPC.RpcKind kind) {
142    switch (kind) {
143    case RPC_BUILTIN: return RpcKindProto.RPC_BUILTIN;
144    case RPC_WRITABLE: return RpcKindProto.RPC_WRITABLE;
145    case RPC_PROTOCOL_BUFFER: return RpcKindProto.RPC_PROTOCOL_BUFFER;
146    }
147    return null;
148  }
149  
150  
151  public static RPC.RpcKind convert( RpcKindProto kind) {
152    switch (kind) {
153    case RPC_BUILTIN: return RPC.RpcKind.RPC_BUILTIN;
154    case RPC_WRITABLE: return RPC.RpcKind.RPC_WRITABLE;
155    case RPC_PROTOCOL_BUFFER: return RPC.RpcKind.RPC_PROTOCOL_BUFFER;
156    }
157    return null;
158  }
159 
160  public static RpcPayloadHeaderProto makeRpcPayloadHeader(RPC.RpcKind rpcKind,
161      RpcPayloadOperationProto operation, int callId) {
162    RpcPayloadHeaderProto.Builder result = RpcPayloadHeaderProto.newBuilder();
163    result.setRpcKind(convert(rpcKind)).setRpcOp(operation).setCallId(callId);
164    return result.build();
165  }
166}