| /* |
| * Copyright (c) 2003, 2009, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| /* |
| * (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| * Copyright 1997 The Open Group Research Institute. All rights reserved. |
| */ |
| |
| package sun.security.krb5.internal.tools; |
| |
| import sun.security.krb5.*; |
| import sun.security.krb5.internal.ktab.*; |
| import java.io.IOException; |
| import java.io.BufferedReader; |
| import java.io.InputStreamReader; |
| import java.io.File; |
| import java.text.DateFormat; |
| import java.util.Arrays; |
| import java.util.Date; |
| import sun.security.krb5.internal.crypto.EType; |
| /** |
| * This class can execute as a command-line tool to help the user manage |
| * entires in the key table. |
| * Available functions include list/add/update/delete service key(s). |
| * |
| * @author Yanni Zhang |
| * @author Ram Marti |
| */ |
| |
| public class Ktab { |
| // KeyTabAdmin admin; |
| KeyTab table; |
| char action; |
| String name; // name and directory of key table |
| String principal; |
| boolean showEType; |
| boolean showTime; |
| int etype = -1; |
| char[] password = null; |
| |
| /** |
| * The main program that can be invoked at command line. |
| * <br>Usage: ktab <options> |
| * <br>available options to Ktab: |
| * <ul> |
| * <li><b>-l [-e] [-t]</b> list the keytab name and entries, -e show |
| * encryption etypes, -t show timestamps. |
| * <li><b>-a</b> <<i>principal name</i>> |
| * (<<i>password</i>>) add an entry to the keytab. |
| * The entry is added only to the keytab. No changes are made to the |
| * Kerberos database. |
| * <li><b>-d</b> <<i>principal name</i>> [<<i>etype</i>>] |
| * delete an entry from the keytab. |
| * The entry is deleted only from the keytab. No changes are made to the |
| * Kerberos database. |
| * <li><b>-k</b> <<i>keytab name</i> > |
| * specify keytab name and path with prefix FILE: |
| * <li><b>-help</b> display instructions. |
| */ |
| public static void main(String[] args) { |
| Ktab ktab = new Ktab(); |
| if ((args.length == 1) && (args[0].equalsIgnoreCase("-help"))) { |
| ktab.printHelp(); |
| System.exit(0); |
| } else if ((args == null) || (args.length == 0)) { |
| ktab.action = 'l'; |
| } else { |
| ktab.processArgs(args); |
| } |
| try { |
| if (ktab.name == null) { |
| // ktab.admin = new KeyTabAdmin(); // use the default keytab. |
| ktab.table = KeyTab.getInstance(); |
| if (ktab.table == null) { |
| if (ktab.action == 'a') { |
| ktab.table = KeyTab.create(); |
| } else { |
| System.out.println("No default key table exists."); |
| System.exit(-1); |
| } |
| } |
| } else { |
| if ((ktab.action != 'a') && |
| !(new File(ktab.name)).exists()) { |
| System.out.println("Key table " + |
| ktab.name + " does not exist."); |
| System.exit(-1); |
| } else { |
| ktab.table = KeyTab.getInstance(ktab.name); |
| } |
| if (ktab.table == null) { |
| if (ktab.action == 'a') { |
| ktab.table = KeyTab.create(ktab.name); |
| } else { |
| System.out.println("The format of key table " + |
| ktab.name + " is incorrect."); |
| System.exit(-1); |
| } |
| } |
| } |
| } catch (RealmException e) { |
| System.err.println("Error loading key table."); |
| System.exit(-1); |
| } catch (IOException e) { |
| System.err.println("Error loading key table."); |
| System.exit(-1); |
| } |
| switch (ktab.action) { |
| case 'l': |
| ktab.listKt(); |
| break; |
| case 'a': |
| ktab.addEntry(); |
| break; |
| case 'd': |
| ktab.deleteEntry(); |
| break; |
| default: |
| ktab.printHelp(); |
| System.exit(-1); |
| } |
| } |
| |
| /** |
| * Parses the command line arguments. |
| */ |
| void processArgs(String[] args) { |
| Character arg = null; |
| for (int i = 0; i < args.length; i++) { |
| if ((args[i].length() == 2) && (args[i].startsWith("-"))) { |
| arg = new Character(args[i].charAt(1)); |
| } else { |
| printHelp(); |
| System.exit(-1); |
| } |
| switch (arg.charValue()) { |
| case 'l': |
| case 'L': |
| action = 'l'; // list keytab location, name and entries |
| break; |
| case 'a': |
| case 'A': |
| action = 'a'; // add a new entry to keytab. |
| i++; |
| if ((i < args.length) && (!args[i].startsWith("-"))) { |
| principal = args[i]; |
| } else { |
| System.out.println("Please specify the principal name"+ |
| " after -a option."); |
| printHelp(); |
| System.exit(-1); |
| } |
| if ((i + 1 < args.length) && |
| (!args[i + 1].startsWith("-"))) { |
| password = args[i + 1].toCharArray(); |
| i++; |
| } else { |
| password = null; // prompt user for password later. |
| } |
| break; |
| case 'd': |
| case 'D': |
| action = 'd'; // delete an entry. |
| i++; |
| if ((i < args.length) && (!args[i].startsWith("-"))) { |
| principal = args[i]; |
| int j = i + 1; |
| if ((j < args.length) && (!args[j].startsWith("-"))) { |
| etype = Integer.parseInt(args[j]); |
| i = j; |
| } |
| } else { |
| System.out.println("Please specify the principal" + |
| "name of the entry you want to " + |
| " delete after -d option."); |
| printHelp(); |
| System.exit(-1); |
| } |
| break; |
| case 'k': |
| case 'K': |
| i++; |
| if ((i < args.length) && (!args[i].startsWith("-"))) { |
| if (args[i].length() >= 5 && |
| args[i].substring(0, 5).equalsIgnoreCase("FILE:")) { |
| name = args[i].substring(5); |
| } else |
| name = args[i]; |
| } else { |
| System.out.println("Please specify the keytab "+ |
| "file name and location " + |
| "after -k option"); |
| printHelp(); |
| System.exit(-1); |
| } |
| break; |
| case 'e': |
| showEType = true; |
| break; |
| case 't': |
| showTime = true; |
| break; |
| default: |
| printHelp(); |
| System.exit(-1); |
| } |
| } |
| } |
| |
| /** |
| * Adds a service key to key table. If the specified key table does not |
| * exist, the program will automatically generate |
| * a new key table. |
| */ |
| void addEntry() { |
| PrincipalName pname = null; |
| try { |
| pname = new PrincipalName(principal); |
| if (pname.getRealm() == null) { |
| pname.setRealm(Config.getInstance().getDefaultRealm()); |
| } |
| } catch (KrbException e) { |
| System.err.println("Failed to add " + principal + |
| " to keytab."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } |
| if (password == null) { |
| try { |
| BufferedReader cis = |
| new BufferedReader(new InputStreamReader(System.in)); |
| System.out.print("Password for " + pname.toString() + ":"); |
| System.out.flush(); |
| password = cis.readLine().toCharArray(); |
| } catch (IOException e) { |
| System.err.println("Failed to read the password."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } |
| |
| } |
| try { |
| // admin.addEntry(pname, password); |
| table.addEntry(pname, password); |
| Arrays.fill(password, '0'); // clear password |
| // admin.save(); |
| table.save(); |
| System.out.println("Done!"); |
| System.out.println("Service key for " + principal + |
| " is saved in " + table.tabName()); |
| |
| } catch (KrbException e) { |
| System.err.println("Failed to add " + principal + " to keytab."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } catch (IOException e) { |
| System.err.println("Failed to save new entry."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } |
| } |
| |
| /** |
| * Lists key table name and entries in it. |
| */ |
| void listKt() { |
| System.out.println("Keytab name: " + KeyTab.tabName()); |
| KeyTabEntry[] entries = table.getEntries(); |
| if ((entries != null) && (entries.length > 0)) { |
| String[][] output = new String[entries.length+1][showTime?3:2]; |
| int column = 0; |
| output[0][column++] = "KVNO"; |
| if (showTime) output[0][column++] = "Timestamp"; |
| output[0][column++] = "Principal"; |
| for (int i = 0; i < entries.length; i++) { |
| column = 0; |
| output[i+1][column++] = entries[i].getKey(). |
| getKeyVersionNumber().toString(); |
| if (showTime) output[i+1][column++] = |
| DateFormat.getDateTimeInstance( |
| DateFormat.SHORT, DateFormat.SHORT).format( |
| new Date(entries[i].getTimeStamp().getTime())); |
| String princ = entries[i].getService().toString(); |
| if (showEType) { |
| int e = entries[i].getKey().getEType(); |
| output[i+1][column++] = princ + " (" + e + ":" + |
| EType.toString(e) + ")"; |
| } else { |
| output[i+1][column++] = princ; |
| } |
| } |
| int[] width = new int[column]; |
| for (int j=0; j<column; j++) { |
| for (int i=0; i <= entries.length; i++) { |
| if (output[i][j].length() > width[j]) { |
| width[j] = output[i][j].length(); |
| } |
| } |
| if (j != 0) width[j] = -width[j]; |
| } |
| for (int j=0; j<column; j++) { |
| System.out.printf("%" + width[j] + "s ", output[0][j]); |
| } |
| System.out.println(); |
| for (int j=0; j<column; j++) { |
| for (int k=0; k<Math.abs(width[j]); k++) System.out.print("-"); |
| System.out.print(" "); |
| } |
| System.out.println(); |
| for (int i=0; i<entries.length; i++) { |
| for (int j=0; j<column; j++) { |
| System.out.printf("%" + width[j] + "s ", output[i+1][j]); |
| } |
| System.out.println(); |
| } |
| } else { |
| System.out.println("0 entry."); |
| } |
| } |
| |
| /** |
| * Deletes an entry from the key table. |
| */ |
| void deleteEntry() { |
| PrincipalName pname = null; |
| try { |
| pname = new PrincipalName(principal); |
| if (pname.getRealm() == null) { |
| pname.setRealm(Config.getInstance().getDefaultRealm()); |
| } |
| String answer; |
| BufferedReader cis = |
| new BufferedReader(new InputStreamReader(System.in)); |
| System.out.print("Are you sure you want to"+ |
| " delete service key for " + pname.toString() + |
| " (" + (etype==-1?"all etypes":("etype = "+etype)) + |
| ") in " + table.tabName() + "?(Y/N): "); |
| |
| System.out.flush(); |
| answer = cis.readLine(); |
| if (answer.equalsIgnoreCase("Y") || |
| answer.equalsIgnoreCase("Yes")); |
| else { |
| // no error, the user did not want to delete the entry |
| System.exit(0); |
| } |
| |
| } catch (KrbException e) { |
| System.err.println("Error occured while deleting the entry. "+ |
| "Deletion failed."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } catch (IOException e) { |
| System.err.println("Error occured while deleting the entry. "+ |
| " Deletion failed."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } |
| |
| int count; |
| if (etype == -1) count = table.deleteEntry(pname); |
| else count = table.deleteEntry(pname, etype); |
| |
| if (count == 0) { |
| System.err.println("No matched entry in the keytab. " + |
| "Deletion fails."); |
| System.exit(-1); |
| } else { |
| try { |
| table.save(); |
| } catch (IOException e) { |
| System.err.println("Error occurs while saving the keytab. " + |
| "Deletion fails."); |
| e.printStackTrace(); |
| System.exit(-1); |
| } |
| System.out.println("Done!"); |
| } |
| } |
| |
| /** |
| * Prints out the help information. |
| */ |
| void printHelp() { |
| System.out.println("\nUsage: ktab " + |
| "<options>"); |
| System.out.println("available options to Ktab:"); |
| System.out.println("-l [-e] [-t]\t\t\tlist the keytab name and entries,\n\t\t\t\t-e with etype, -t with timestamp"); |
| System.out.println("-a <principal name> (<password>)add an entry " + |
| "to the keytab"); |
| System.out.println("-d <principal name> [<etype>]\tdelete an "+ |
| "entry from the keytab"); |
| System.out.println("-k <keytab name>\t\tspecify keytab name and "+ |
| "path with prefix FILE:"); |
| } |
| } |